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Siril 0.9.9 User guide 


Siril 0.9.9 


It is an astronomical image processing tool, able to convert, pre-process images, help aligning them 
automatically or manually, stack them and enhance final images. 






M33 by Cyprien Pouzenc 


In line with programs like Irig/"#P-™wastrosurt.com/builins/ris.htm] | Siri\lP-197] ig targeted to amateur 
astronomers having acquired images and wanting to process them in a semi-automatic way. 


lt provides a more user-friendly interface than Iris' command line as well as more modern and powerful 
processing algorithms, but it is not yet as automated as DeepSkyStacker or Registax. 


It also provides a basic command line to access various processing functions. 
Siril is fully capable to pre-process and process deep sky images. 


One feature still missing for planetary images processing is image deformation, but it is still capable of 
registering and processing them in an elegant way. 

The new star detection registration is perfect for deep sky images, but there are also two automatic 
translation-only registrations, one more suited for planetary and bright nebula images, based on DFT. Ps 
‘/en.wikipedia.org/wiki/Discrete_Fourier_transform] and another more simple targeted at deep-sky images, based 
on psplhitp.//en. wikipedia.org/wiki/Point_ spread_function] ona singl e reference star. 

Additionally, a manual alignment capability makes it also well fitted for amateur astronomers having 
feature-less or bad quality images that automatic tools fail to align properly. 


Professional astronomers generally use 32-bit depth images, but Siril uses only 16-bit images 
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internally (except temporary for stacking). 
Loading 32-bit images is supported but it will degrade them since they will be converted to 16-bit. It 
can still be useful if the intent is to produce public-friendly pictures. 


1O) 


And more generally, people who want to use free software on free operating systems to process 
images. Siril can even be used to extract previewed frames from many videos formats. For an 


overview, see some imag e processing results /https/free-astro.org/index.php/Siril:Results] 


| The current version is 0.9.9 


TO, 


Follow us on Eacebooklhites:/www. facebook. com/Siril-319634734887195/] E] 


b 
Le 
e 


Or on Webastro!tie-www. webastro.net/forum/showthread. php ?t= 122969] forum a 


If you like the software, please help us by contributing with the Donate button herel/”fps//free-astro.org 


/(index.php/Sirill Siril took us a lot of time and we still have to pay for the server. 
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1. Siril functions 


1.1. Siril features 


New features are being introduced quite regularly. 


Native image format support 

@ Unsigned 16-bit FITS files (other FITS are converted to this format on-the-fly) 
© SER files 

@ AVI and many other film files, their support is being dropped in favor of SER. 


Image conversion (to the native FITS format only) 


© Supported input types: 8-bit and 16-bit BMP, TIFF, JPEG, PNG files, NetPBM binary images, RAW 
DSLR images. 


Pre-processing of images 


@ With multi-channel offset, dark and flat images. 


Image registration; supported methods: 
è Global star alignment (rotation + translation) 


® Translation using DFT/#PS//en.wikipedia.org/wikl/Cross-corelation] centered on an object, generally used 
for planetary images 


è Translation using pspiiitips.//en.wikipedia.org/wiki/Point_ spread_function] of a star, generally used for deep- 
sky images 


@ Manual translation with two preview renderings of the current image with reference frame in 
transparency 


© Since 0.9.8 


© Subpixel alignment for stacking, or more exactly half-pixel alignment, with the feature called 
simplified drizzle 


Registered sequence export 


© Supported export file formats: Siril FITS sequence, SER sequence, uncompressed AVI files, GIF up 
to 0.9.4, MP4 and WEBM web publishing video formats since 0.9.5 


Optional cropping and resizing of the exported images 


Archiving planetary videos 
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Image stacking 

Summing 

Median 

Percentile clipping 

Sigma clipping 

Median sigma clipping 
Winsorized sigma clipping 


Linear fit clipping 


Pixel minimum/maximum 


© Since 0.9.8 


| @ Sum stacking now runs in parallel 


Q 


16-bit normalization of 8-bit images stacked with deviant pixel rejection algorithms is possible since 
version 0.9.9 


Enhancement and processing of final images 


@ Lighiness/contrast sliders on each layer, different scaling modes (linear, log, square root, squared, 
asinh, histogram equalization), negative and false color rendering and clipping 


Background removal tool 
Cosmetic correction tool 


Lucy-Ritcharson deconvolution tool 


Command line for various processing functions 


@ Available from the GUI, see the list of available rrcommands. 


Q 
| 


Each command is documented. 


Scripts 


Since version 0.9.9 it is possible to create scripts to automate processing. 


Photometry features 
@ A star finding algorithm with PSF information 


© Light curve data output suitable for plot tools, for one star in a sequence (working in progress) 


Today,Siril uses the curves during the registration. So it can be a star, if "one-star registration" is 
used, or the average of the detected stars. 


For planetary, quality is used (which goes from 0 to 1). 
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Image compositing tool 


@ Image compositing tool, combining and aligning multiple layers (1 Luminance + 1 to 7 possible 
colors) with custom colors into a resulting image, with luminance layer support 





ENEC HCNT HT ¢ 
$ i 
:: EUR EEE: i 
Hell) $ 


IQ 


Leveraging the new scripting, Siril 0.9.9 has been integrated as an automatic way of processing 


acquisitions in the capture software CCDciel!tes/www.ap-.nev/ccdciel/ir/start] 


1.1.1. New of 0.9.9 version 


@ Major update of the command line, with completion and documentation in the GUI, enhanced 
scripting capability by running commands from a file and also allowing it to be run with no X11 server 
running with the -s command line option. 


@ Added commands to stack and register a sequence 


Image statistics, including auto-stretch parameters and stacking normalization, are now cached in 
the seq file for better performance 


Global star registration now runs in parallel 

Workflow improvement by adding demosaicing as last part of the preprocessing 
Added a filtering method for stacking based on star roundness 

Added an option to normalize stacked images to 16-bit with average rejection algorithm 
All GUI save functions are now done in another thread 

Improved histogram transformation GUI 

Improved support of various FITS pixel formats 

Added native open and save dialogues for Windows users 

Fixed wrong handling of scale variations in Drizzle case 

Fixed 8-bit images auto-stretch display 

Fixed BMP support 

Fixed issues in PNG and TIFF 8-bit export 

Fixed the "About" OS X menu. 


1.2. Work on a sequence of converted images 


Once you have your Siril's format .fit files, you can switch to the | Sequence | tab seen below. 
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| x 5 [=] Siril control center 


File Edit Image Processing Analysis Windows Help 























File conversion Image sequences Pre-processing Registration Stacking Output logs 


fomewated in sequences. Sin! can find sequences in CWD, and you can filter images out. 
Sequence selection 
NGC7635 _.seq a 
[ | force .seq recomputation 
dark_.seq 
<NGC7635_ flat_seq 


00001 excluded |_| reference image 


| exclude all include all 




















Sequence export 





Base name: | | FITS + | | Export sequence 


|_| Normalize images 

















Console 


Type help for the list of supported commands 


Current working directory: /home/cynil/images/Bulle | Stop | | Change dir... | 


Current working sequence: NGC7635_, 13 images selected Mem: 161MB | a _ | 





P Sequences 


Sequences are what Siril uses to represent the manipulated files. 


Three file types are natively supported: 


a set of two or more FITS files, a single SER file or, to some extent, a regular film file such as AVI 
or any other container. 


À 


Film files support is being dropped in favour of SER, but simple £P sum stacking '°4"! can still be 
done on them. 


The file extension for FITS files can be configured in the settings, by default itis . Æ2£. Changing it 
will change the extension used to detect FITS sequences in the current working directory, but also 
the extension of the files created by Siril in conversion or any processing that creates an image. 


1) 


Click on the search sequences) button. 





If you only have one sequence in the working directory, it is automatically selected and loaded. 
Else, the list will pop-up and you'll be able to select the sequence you want to use. 
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When the sequence is loaded, two windows may be opened: the grey frame control window, on the 
left of the image below, and the RGB composition rendering window, behind the main window on the 
image below. In the case of monochrome images or CFA files, only the grey frame window will be 
opened. 


nl Cc F cA ls El F E Aotik = 2 at 








search sequences 


The grey window is used to display color components for the image, control their visual composition in 
the color image, and give information about the displayed frame, pixel value when moving the mouse on 


a pixel, file name and layer number, zoom value, FWHM!?:"®*! value of the selection if it applies, and 
some display tools. 


1.3. Registration 


P Registration 


Registration is basically aligning the images from a sequence to be able to process them afterwards. 


Calculate shift in images to be aligned with the reference image 


Images are not modified, only shift parameters are saved in regparam in the sequence. 


* 


| Layer is the layer on which the registration will be done, green by default (set in 
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| siril init ()) 


Â Ifin Images Sequence tab reference image is set: 


The current image will be the reference image for registration. 


Only one image can be the reference image in a sequence, setting it will unset the image previously 
set as reference. 


If not set manually, the first image of the sequence is taken as reference. 





File conversion | Image sequences Pre-processing Registration Stacking Output logs 





Images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out. 


Sequence selection 


Sequence: | r_ring_.seq z Search sequences 








( | force .seq recomputation 


Image selection in sequence 
<r_ring_.seq>: 99 images selected out of 99, reference image is 00047 


| 00047 — +| O excluded reference image 














exclude all include all 








© Adjust Registration settings 
Open =Analysis/Dynamic PSF... 






y - = ~A MS rnrace 7 A . OP PT mt r 
| le Edit age Processing Analysis Windows Help 






File conversion Sequence Pre-prod aea Plot Stacking Output logs 


This conversion tab is used to 2m into a format with which Siril can work: FITS or SER. 


Source 
Name Date dh 
= 
x] 
Destination 
G Colour image target 
che k © Keep three channels 
= ae ` Create three images 
convert (| Demosaicing 


`) Keep only first channel 


BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, 


Supported filetypes: cir sequences, TIFF images, JPG images, PNG images. 


Console 


| Type help for the list of supported commands | | 


Ready. 





Current working directory:/media/laurent/Data/save juillet 2016/astro stop | | Change dir... 








Current working sequence:-none - Mem: 63MB l4 — + | | 





Dynamic PSF (for registration settings) 


Adjust registration settings 
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Dynamic PSF 

Ch. B A x0 yo FWHMx FWHMy r Angle RMSE 
a ELA TES NT El ANR Een 
adius: 7 il ie à 
PE te 
ireshold: 1.00 — + 
ee i} 
loundness threshold: | 0.6 — +1 


Close 





@ Radius 


Radius: | 7 i uaa 
Size in pixels of the search box. 


© Threshold value | | 
Threshold: | 1.00 = | 


Threshold value above the noise for stars detection. 


The median and standard deviation values of the image are determined, then the threshold is: 
median + [threshold] x stdev. 


& 
| The default value for threshold is 1.00. 


© Threshold value | 
Roundness threshold: | 0.6 — + 
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Threshold value of star roundnesses. Decrease this value if your stars show small trails. 


Ensure you have a good reason to change this value because it may degrade the star detection. 


1.3.1. One Star Registration (deep-sky) 


Image registration 





© Register all images from sequence Register selected images only 
Choose registration method: | One Star Registration (deep-sky) vy | Select registration B 0 Luminance (*) v 
Ve ne ee ee m 
SS a ES 
Go register Follow star movement ! 





| 0: Luminance (*) + | 


Layer on which the registration is done. 
It can only be done on one layer at a time, so on monochrome images. 


The (*) sign appearing after the layer's name means that registration data is already available for 
this layer. 


— 1Q 


D 
When processing images, registration data is taken from the default layer if available (for RGB 
images: Green, else fallback to Blue then Red). 


@) Follow star movement 


| | Follow star movement 


Use this option to use the position of the star found in the previous image as new center for the 
current image registration. 

This allows the selection area to be smaller, registration faster, and accounts for drift or images with 
a large number of stars. 


Enabling this option requires the registration to not be parallelized, it will run on one CPU core 
only. 
This is the simplest method to register deep-sky images. 


Because only one star is concerned for register, images are aligned using shifting (at a fraction of pixel). 
No rotation or scaling are performed. 
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Q 
| 


Shifts at pixel precision are saved in seq file. 


1.3.2. Global Star Alignment (Deep-sky) 


Image registration 








© Register all images from sequence Register selected images only 
Choose registration method: | Global Star Alignment (deep-sky) vy | Select registration layer: 9 Green (*) v r 
Prefix: |r_ | Algorithm: anczos-4 z } Match stars in bel S, Translation only : 
oes es Ss se es ee ee er LEE = Pewee ee ee ee 
Go register 


[ | Match stars in selection 


(¥ Match stars in selection Check this box if you want to perform the Global Star Alignment 
algorithm within the selected area in the reference image. If no selection are done, this option is 
ignored. 


| Make sure to draw a selection with a sufficient number of stars. 





Go register 


Start the registration process 
It will register images in the loaded sequence using the selected method and reference layer. 


x 
| Loaded in the ‘Image sequences’ tab, current sequence name is at the bottom of the window too. 





1: Green (*) + 


Layer on which the registration is done. 
It can only be done on one layer at a time, so on monochrome images. 


Q 
The (*) sign appearing after the layer's name means that registration data is already available for 
this layer. 


14 06/08/18 Version : 1.53 The free-astro development team, 2018 Siril 0.9.9 


User guide Siril functions 


= 
When processing images, registration data is taken from the default layer if available (for RGB 
images: Green, else fallback to Blue then Red). 


Lanczos-4 bé 


Type of algorithm used for rotation 
Choose algorithm: 


@ Nearest Neighbor 
© Bi-linear 

@ Pixel Area Relation 
© Bicubic 


© rr?Lanczcos-4 


© Translation only 
[_] Translation only 


œ 
This is the only registration that can detect and apply rotations on images. However, rotating 
_ images will degrade them to a certain extent. 
X 
Activating this will use the same image alignment algorithm but only apply one-pixel accurate 
translations (rotation is computed, but not applied). 





Q 
| This is useful for image sequences with very small rotation angle. 


no new sequence is built, registration data is stored in the original sequence. 
Since version 0.9.7, Siril uses a new and more robust alignment algorithm than previous releases. 


Any automatic image alignment algorithm (either for panorama or Astrophotography purposes) must 
detect relevant image features, Known as control points. 

These points must be matched by correspondance on two images (reference and target) in order to 
determine the transformation that a software could apply. Luckily, in deep sky astrophotography, stars 
are nearly ideal control points. 
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Siril alignment works as follow: 
® Stars are detected in the reference image. The number is displayed in the Siril consol. 
© Stars are detected in the target picture, similarly their number is displayed in Siril consol. 


è Analgorithm is building triangles from the brightest detected stars in the reference image, then there 
are associated to the corresponding triangles in the target one. 


© A first order transformation is computed and stars are matched between them in the two images. The 
number of matched stars is shown in the Siril consol. 


@ The two lists of stars are processed with a new algorithm named RANSACIHles:/en.wikipedia.org/wiki 


/Random_sample_consensus] This algorithm is abled to deal with a large fraction of outliers in order to 
only keep good stars. 


© This is a 3 x 3 matric with 8 degrees of freedom like: 


ABC 
H=|DEF 
GH1 


This algorithm makes it possible to ignore the stars which it considers unreliable in order to determine a 


new more precise transformation, expressed in the form of a homographic matrix!#es./en. wikipedia.org/wiki 
/Homography] 


When G = H = 0, it is an affine transformation, or linear, which is often the case. 


Q 


GIMP 2.9 has a good use of the homographic matrix in its "Unified Transform Tool". 
= You can easily how the transformation will change matrix parameters. 





| A new sequence is created with the prefix of your choice (r_ by default). 


1) 


Since Siril 0.9.7, Images registration can be applied to images with different focal lengths and/or 
sizes. 
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1.3.3. Simplified Drizzle x2 


Ci Siril control center 
File Edit Image Processing Analysis Windows Help 


File conversion Sequence Pre-processing | Registration Plot Stacking Output logs 


Registration is basically aligning the images from a sequence to be able to process them aftenwards. 
Image registration 


© Register all images from sequence _ Register selected images only 


Choose registration method: | Global Star Alignment (deep-sky) T Select registration layer: T 
Go register [M Simplified Drizzle x2 Load a sequence First. 


ty 


X translation: 0 = | of | Y translation: 0 = | of | 


Display reference image Set reference image first. | Set first preview || Set second preview | 


Type help for the list of supported commands 
NN 
Current working directory: /home/laurent/Moodle Siril/m31 | oe Stop | | Change dir... | 


Current working sequence:- none - nie |4 |=] + | 


Disk Space: 383G 





/ Simplified Drizzle x2 


Activate the simplified drizzle algorithm for the processing of this sequence. 


An up-scale (x2) will be applied to the registered frame or during stacking depending on which 
registration is chosen, that will result in higher resolution images. 


This option is adapted for under-sampled images, i.e, when the telescope focal length is too short 
for the pixel size. 


One may consider that the system is under-sampled when FWHM is smaller than 2 pixels. 


The correct name of this method should be super-resolution stacking, but for a more convenient 
understanding we called it Simplified Drizzle x2 


the counterpart of this technique is that the amount of memory and disk space needed to create 
and process drizzled images is multiplied by the square of the Drizzle factor. 
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1.3.4. Image Pattern Alignment (planetary-full disk) 


Image registration 








O Register all images from sequence Register selected images only 
Choose registration method: | Image Pattern Alignment (planetary - Full disk) vy Select registration layer: | 0: Luminance (*) + | 
Go register 





This is a simple registration by translation method using cross correlation in the spatial domain. 


This method is fast and is used to register "planetary movies. It can also be used for some deep-sky 
images registration. 


Q 


| Shifts at pixel precision are saved in seq file. 


1.3.5. Enhanced Correlation Coefficient Maximization (planetary-surfaces) 


Image registration 


© Register all images from sequence ` Register selected images only 





Choose registration method: | Enhanced Correlation Coefficient (planetary - surfaces) v | Select registration layer: | 0: Luminance (*) + 





Go register 





It is based on the £P enhanced correlation coefficient maximization algorithm. 


This method is more complex and slower than Image Pattern Alignment but no selection is required. It is 
good for moon surface images registration. 


Although the rotation is possible with this algorithm, but it was currently decided to only allow a 
detection of translation. 


1.3.6. Manual Registration 


Manual registration 


. | display reference image Set first preview Set second preview 


X translation: Le - + ¥ translation: g —- + 





= l 
-On501E 


In some case manual registration is very useful for a few frames 
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The reference image is displayed with a transparency of 50%, it must be selected before manual 
alignment. 


Then select an image area with a single click in it for translation in x and another for the y 


Q 


The mouse wheel or up or down and left or right arrows can be used to perform the translation in x or 
y. Simply select first the axis of movement by clicking in X translation or Y translation entry field when 
the mouse wheel is used. 


1.4. Plot 


A new, very useful function has just been added 
© 


Main use : you can select with many criteria the images to be stacked. 
© 


Or use the data by exporting csv for many other purposes like photometry 


Q 


Use of csv data export 


| It is very useful for observing variable stars, like Eclipsing binary of Algol type. 


Default view 


After a first registration a graph is displayed 


Siril control center 
File conversion Sequence Pre-processing Registration Plot Stacking Output logs 


4.80349 


4.53178 


: 4.26007 














3.716644 i 
[ 2.75 9.5 8.25 11 
Frames 
Filename: | Plot | Export to CSV | Clear all | Clear latest Registration v | 
Console 
| Type help for the list of supported commands 





| 
Finished computing PSF for the sequence. Ready. 
Current working directory: /home/laurent/Documents/traitement 


@Stop| | Change dir... 
Current working sequence:r_bulle_, 12 images selected Mem:330MB | 4 





_ +. 
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Q 


| The reference image is surrounded 
You can select a reference image before computing a new alignment with reference to it 


File 
m33_00011.fit 


Green channel | Blue channel 


File conversion Sequence Pre-processing Registration Plot Stacking Outputlogs 


m33 00013.fit 
m33_00008.fit 


|| Green  x:4145y: 1586 = 147 m33_00011.fit (chan 
m33_00002.fit _ 


~) cut 


Q= 


m33_00015.fit : j D C P- A W G 


a 








Current working directory: /home/laurent/Documents/traitement 





@stop | | Change dir... 
Current working sequence:m33_, 30 images selected Mem: 467MB 4 |—|+ 


Q 


Use show/hide list of images in the sequence with registration data in gray channels images 
windows to select or deselect images 


1O) 


| The current image is selected by a double click in the list 


1O) 


| The reference image is selected in the F4Sequence tab 


Get more information 


You can also choose to have more information to set your reference image or remove images 


== Get more information from a set of images 
Q 


When you use this feature for other purposes than stacking, it is more meaningful to obtain 
additional information about a sequence, if it has been normalized. 
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Q 
| No registration is necessary, simply load the sequence 


GD Pick up a star 
In Gray Channels images windows 


Draw a box around the star 


siril v0O.9.5-beta - /home/laurent/Documents/traitement 





Red channel Green channel Blue channel 


















i eR ‘M à É à i 
Green x: 2726 y: 0301 = 335 r bulle 00001.fit (channel 1) Fwhm = 5.75, r = 0.91 
cut o_O 3 1 82 7 M i n /M ax 

MIPS-LO/HI 
= 0 User 
$È fr — AX LL, of E AutoStretch + 1:1 hd 
Q 
| Use zoom level for more accuracy 
E) Right click and choose PSF for sequence 
Siril 0.9.9 
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# file X Y sel qualit Red channel | Green channel Blue channel 
„0 rbulle oovotfit 0 0 @ 3.717 § 
U5___rbulle ooo6fit o 0 Œ 3.889 ` 
1| mmrabulle 00002.fit O O 3.895 fa 










Ki 
E3 r_bulle_00004.fit 0 0 4.187 


__f_bulle_oooos.fit 0 0 4.209 






r_bulle_00003.fit 






I 00 
11 r_bulle_00013.fit 0 0 
U7  r bulle 00009.fit 0 0 4.738 
r_bulle 00012.fit 0 0 


PSF for the sequence 





7 cut 30447 Min/Max 


MIPS-LO/HI 
Qa 0 Use 


D, C > À A 6 oF B AutoStretch + Zoom to Fit 








Siril control center 
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0.96497 19) a. 


0.899603 


Star roundness (1 is round) 











0.834235 
0.768866 a * OA NN 
0.703498 
0 2.75 5.5 8.25 11 
Frames 
Filename: Export to CSV || Clear all || Clear latest Roundness v || Photometry v 
Console 





| Type help for the list of supported commands | 


Finished computing PSF for the sequence. Ready. 





Current working directory: /home/laurent/Documents/traitement @stop| | Change dir... 





Current working sequence:r_bulle , 12 images selected Mem: 347MB 4 - +] 


€) Repeat the previous step until you have a representative sample of stars 
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Result 


Siril control center 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 


0.98325 








0.877136 








T 
= 
= 
E 
= 
á 0.771022 
= 
T 
Z 
2 
5 0.664907 
0.558793 | | 
0 2.75 a 25 11 
Frames 
Filename: Pot Export to CSV || Clear all | Clear latest Roundness v || Photometry v 
Console A 


| Type help for the list of supported commands | 


Finished computing PSF for the sequence. Ready. 


Current working directory:/home/laurent/Documents/traitement @Stop| | Change dir... 





Current working sequence:r_bulle , 12 images selected Mem:330MB |4 — +) 








General comments 
Now you have the following information to optimize your choices for the selected image or the 
reference image: 
Roundness 
FWHM 
Amplitude 
Magnitude 
Background 


Star position on X axis 


Star Position on Y axis 


Q 


Each star is identified as a circle which color is identical to the color of the corresponding curve in 
the graph. 
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siril vO.9.5-beta - /home/laurent/Documents/traitement 





Green channel | Blue channel 





Red channel 








Fwhm: no selection 












Green X: 4170y: 0197 =310 r bulle 00001.fit (channel 1) 
cul : 31827 dt kite 
= ip — A A, af eS AutoStretch ¥ Zoom to fit + 


© Additional data 
When Siril is launched in command line from a Linux console 


"© © laurent@Astro-PC-bureau: ~ 
laurent@Astro-PC-bureau:-$ sirilf 





Additional data is displayed in the console as the position of the selection and its size in pixels 
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laurent@Astro-PC-bureau: ~/siril 


log: See the console for a dump of star data over the sequ (stdout) 
# image no amplitude magnitude fwhm x y 
Purging previously saved reference frame data. 
Purging previously saved reference frame data. 
Purging previously saved reference frame data. 
pe 4127,1842, 1x0 
lecti 4236,1766, 19x18 
es ng the PSF on the Loaded sequence, layer 1 


tT iD 


D E 
Mi 


Results will be displayed at the end of the proc ing, on the conso 
in the following form: 
Starting sequence proce 


Ca] 
LE 


uni 


sing of 
r_bulle_90001.fit 
r bulle 00002.fit 
r bulle 00003.fit 
r bulle 00004.fit 
r bulle 00005.fit 
r bulle 00006.fit 
r bulle 00008.fit 
r bulle 00009.fit 
r bulle 00010.fit 
J e- 

e 


Loaded partial FITS fil 
Loaded partial FITS fil 
aded partial FITS fil 
Loaded partial FITS fil 
Loaded partial FITS fil 
Loaded partial FITS fil 
Loaded partial FITS fil 
aded partial FITS fil 
Loaded partial FITS fil 
aded partial FITS fi 
anit partial FITS r bull ee 
aded partial FITS r bulle 90013.fit 
ri nar sequence processing of PSF 


i 


rat] 


D mM 


D fl 


fl 


D D 


= 
= m 
= 


=] 


r bulle 00011.fit 


F 
4 F 


D D fl 


F 
F 








Siril control center 
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Star roundness (1 is round) 














0.664907 
0.558793 
0 2.75 Dual 25 11 
Frames 

© ——…— /ç == =... oe EL 

ds Plot Export to CSV 5 lear all ee 1 2 Sets v 3 Photometry v 1 

a AS j mrn "m l l-a a ee 

Console 
Type help for the list of supported commands 
Finished computing PSF for the sequence. Ready. 
Current working directory: /home/laurent/Documents/traitement @stop Change dir... 





Current working sequence:r_bulle_, 12 images selected Mem: 330MB -a Gui a 


1) Selected reference image 


The reference image is surrounded 
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2 Select which information 


Roundness + 


Roundness 
FWHM 
Amplitude 
Magnitude 
Background 


X position 


Y position 


© Information 
Photometry + 


Select the source of graph information. 
@ Photometry 


e Alignment 


© Export 
Filename: | | Export to CSV 


al 5 
n 


Export graph to csv 
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06/08/18 


© Exploitation of a csv export: Cy Aqr2 





Reset graph data 


Version : 1.53 
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© Clear latest 


Clear latest 


Erases the last curve 


x 


The model computes a Gaussian task with two axes, the major axis X and the small axis Y for the 


slightly elongated stars. 


Roundness 


Siril control center 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 


0.98325 














3 0.877136 

= 

= 

£ 

k. 

2 0.771022 

a 

T 

= 

2 

= 

5 0.664907 

0.558793 j z 
0 2.7: + ied 11 
Frames 

Filename: | || Export to CSV | Clear all | Clear latest Roundness v || Photometry v 
Console 

| Type help for the list of supported commands | 

Finished computing PSF for the sequence. Ready. 
Current working directory: /home/laurent/Documents/traitement @stop | Change dir... 
Current working sequence:r_bulle , 12 images selected Mem:330MB |4 — + | 








| The roundness parameter. It is expressed as fwhm_Y /fhwm_X 


A 


| The range is 0 to 1 
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FWHM 


Siril control center 


Fileconversion Sequence Pre-processing Registration Plot Stacking Outputlogs 


Cy) ee ee ere eee err cer eee (iMod enets anced pnhend aces useedeevetedeens enon eassdnen duets Ged edenesesneeeeiee nes rere eee rere eee eter . 





D 8.25 11 


gn 


Frames 
Filename: | Plot | Export to CSV | Clear all | Clear latest | FWHM v | | Photometry v 


Console 
| Type help for the list of supported commands 


| 





Finished computing PSF for the sequence. Ready. 





Current working directory:/home/laurent/Documents/traitement | @Stop | | Change dir... 


Current working sequence:r_bulle , 12 images selected Mem: 356MB |4 — + | 


| The Full Width Half Maximum! 1391 
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Amplitude 
Sequence Pre-processing Registration Plot Stacking Outputlogs 


File conversion 


0.239382 q 





0.183742 


0.128102 


C 


Amplitude 


0.0724619 } a 
0.0168221 O_o r >. | 
8.25 11 


0 





Amplitude + || Photometry v 





|| Export to CSV || Clear all | Clear latest 





Filename: | Plot 
Console 
| Type help For the list of supported commands | 


Finished computing PSF for the sequence. Ready. 


@stop | Change dir... 


Current working directory:/home/laurent/Documents/traitement 
Mem:356MB [4 — +) 





Current working sequence:r_bulle , 12 images selected 


The maximal intensity of the star in the [0, 1] range: it is the A parameter in 2d Gaussian! 13% model. 


It is the peak value of the fitted function, located at the centroid coordinates x0 and yO. 
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Magnitude 


Siril control center 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 











ADOPTE 255 users. ELEC PERS CESSE RES ART ite dass sateen: eee err : 
= : : : 
Le . x 
E : | | —+ 
® 11.7807 | ee ns PRES TP IS RMS RNEN ERP CARRE AREA mme ER CLEP coca ee 
À —— —eo o - 
5 ; 

E (D 

tw 

Le 

2 7)! ke Cnn ssn Sn nnn enn nnn hhh hh hhh nn hhh hhh hhh hhh hhh then hth hc eee 
r 

T 

Z 

= 

D | ; 
E -13.4066 H::...................................... LE E E O A | ST RE esol ble oe 
: 

ae a a onom oeo eo 

-14.2195 —— 

0 2:75 5.5 8.25 11 
Frames 
Filename: | Plot Export to CSV | Clear all | Clear latest Magnitude + || Photometry v 
Console | 
| Type help for the list of supported commands | 
Finished computing PSF for the sequence. Ready. 

Current working directory: /nhome/laurent/Documents/traitement @Stop| | Change dir... 

Current working sequence:r_bulle , 12 images selected Mem:356MB |4 — + | 











_ The magnitude is the integral of the Gaussian 


A 


| Without Calibration with (Seémag It is given in ADU units-83 


Q 


You can rPnormalize your sequence and use the command r?setmag to calibrate the selected 
star's relative magnitude 


setmag associates an ADU integral with an apparent magnitude value and allows to express the 
apparent magnitude of the other images. It is just an offset. 
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Background 


Siril control center 





Fileconversion Sequence Pre-processing Registration Plot Stacking Outputlogs 


0.0046862 CRETE Se de ln à | 


0.00439868 








v 
= 
T 
> 
5 . 
3 0.00411113 
ba 
Z 
oO 
Le] 
a) 
0.00382358 
0.00353602 
0 2:75 <a 8.25 11 
Frames 
Filename: | Plot || Export to CSV || Clear all | Clear latest | Background + | Photometry v 
Console 


| Type help for the list of supported commands | 


Finished computing PSF for the sequence. Ready. 


Current working directory:/home/laurent/Documents/traitement | @stop | Change dir... 


Current working sequence:r_bulle , 12 images selected Mem:356MB |4 — +) 


The sky background is an average of the sky background pixels around the star or the level from 
which the gaussian starts. 
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Star position on X axis 





Siril control center 


Fileconversion Sequence Pre-processing Registration Plot Stacking Outputlogs 


ORG Q a otc IT Sabb Neo à sede à Be nie Due DEE on din un Es Gone REMAN EMCEE ES OEE peeces reteset 


3337.93 E E bys uauy Re ne ee CU a 
E : : : 
# 
= 
© | | | 
RE ST I ea hed eran cea cep PS EE TO ES 
= | | 
Z : 
a 
5 

EP CE RSR ETE AE 


3220.75 ¢ 


0 3 6 Q 12 
Frames 
Filename: | || Export to CSV || Clear all | Clear latest | Xposition v || Photometry v 


Console 
| Type help for the list of supported commands | 


Finished computing PSF for the sequence. Ready. 





Current working directory: /home/laurent/Documents/traitement @stop | | Change dir... 
Current working sequence: bulle_, 13 images selected Mem:357MB |4 — + | 


À 


| Do not make registration 
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Star position on Y axis 


Fileconversion Sequence Pre-processing Registration Plot Stacking Outputlogs 


2429.919 


2340.94 


Star position on Y axis 


2296.46 





Filename: | Plot 


Console 


6 


Frames 


Export to CSV || Clear all || Clear latest 








Y position v 


User guide 








Photometry v 





| Type help for the list of supported commands 


Finished computing PSF for the sequence. Ready. 


Current working directory:/home/laurent/Documents/traitement 


Current working sequence: bulle , 13 images selected 


Do not make registration 


— IQ 


csv data export 


You can export data of an images sequence 


Order of columns: number of the image, sample n to n+x 
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O 0.00391868 
1 0.00386159 
2 0.00383173 
3 0.00375529 
4 0.00372182 
5 0.00368188 
6 0.00362026 
7 0.00357674 
8 0.00357034 
9 0.00356047 
10 0.0035689 

11 0.00351931 


Version : 1.53 


0.00409481 
0.00411887 
0.00407711 
0.00401785 
0.00397001 
0.00391017 
0.00386605 
0.00381525 
0.00378527 
0.00378576 
0.00378053 
0.00371972 


0.00419305 
0.00415182 
0.00406276 
0.00405879 
0.00399752 
0.00393777 
0.00388906 
0.00379023 
0.00378296 
0.00384871 
0.00379046 
0.00372365 


0.00402577 
0.00407796 
0.00400722 
0.00399004 
0.00395035 
0.00389273 
0.00385509 
0.00378899 
0.0037729 

0.00382624 
0.00379193 
0.00373539 


@Stop 


Change dir... 





Mem: 357MB 


0.00366996 
0.00367079 
0.00358929 
0.00354695 
0.00343857 
0.00348703 
0.00355442 
0.00339784 
0.00338058 
0.00352673 
0.00353248 
0.00349799 
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You can use these data to calculate the mount's periodic error curve with the appropriate sequence. 
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® You can export data for : 
@ Roundness 

FWHM 

Amplitude 

Magnitude 

Background 

X Star position 


Y Star position 


iC) 


| The csv file is saved by default in the current working directory 


Q 


Use Stell arium/tp//www.stellarium.org/] or Kstars/itps//edu.kde.org/kstars/] in association with astrometry. 
n et/hitp///astromeiry.net/] remotely P AOvaASromeny TEN or | ocally toi dentify the stars 


Setmagseq 


© setmagseq 


setmagsegq magnitude 
This command is only valid after having run segpsf or its graphical counterpart (select the area 
around a star and launch the psf analysis for the sequence, it will appear in the graphs). 


This command has the same goal as setmag but recomputes the reference magnitude for each 
image of the sequence where the reference star has been found. 


Q 


When running the command, the last star that has been analyzed will be considered as the 
reference star. 


Displaying the magnitude plot before typing the command makes it easy to understand. 


| To reset the reference star and magnitude offset, see unsetmagseg. 


© Example of using the | Setmagseg command 


Make a usual segpsf to have a curve. 
@ Display the graph of magnitudes to have a visual feedback 


© Type setmagseg 10 if it does 10 of magnitude 


@ Takea look to the result 
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| The last star that was studied with segpsf is defined as reference. 


Q 
| 


Look at the info messages on the console output tab 


Q 
| 


Undo with wasetmagseg 


1.5. Aperture photometry 


P Aperture photometry 


Aperture photometry is a technique concerned with measuring the flux of an astronomical object. 


In our case, the tool will extract the raw star magnitude that could be compared to the real 
magnitude as stored in catalogs. 


The technique consists of summing all unsaturated and non-zero pixels within an aperture centered 
on the object. 


The aperture radius is defined from the fwhmlP##l of the object. 


Then the product of the nearby average sky count per pixel and the number of pixels within the 
aperture are subtracted. 


AnnNLILUS 


A UE L LIT = 


To estimated local background, we use another aperture that has an annular shape. 
In ideal case this sky annulus should only contain sky pixels, but a robust mean-algorithm, the 
same used in the C-Munipack software/"#P//c-munipacksourceforge.net] | rejects outliers. 


The annulus is defined with the radii of two circles. 
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By defaut, inner radius is of 20 pixels and outer is of 30. 


Q 
lt is possible to change these values in the setting box. 
Settings 
DSLRRAW debayer Other debayer Camera & Optics Photometry Misc. 
Camera 
ADC gain: | 2.30000 — +) 
Background 
Size of the annulus For background level measurement (pixels): N 
Inner radius: (20.00 — +| 
Outer radius: (3000 |— +) 
_ | Restore to Default | 
OK 
© 


The other parameter is the conversion parameter of electrons by ADUFP 831 to have the real ADU 
If not available, 2.3 should be sufficient. 


Q 


Enter focal and pixels's size in parameters / camera & optics, Siril works in arc second. This 
updates the circles. 


Q 


| For our exoplanet images, this coefficient is stored in the header and its value is of 5.0. 


This allows you to process your Variable Star or Planetary Transits sequences. 
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© Planetary Transits. 


Le = . siril v0.9.6-beta4 - /home/cyril/Images/exoplanete 2 












x = o Fenêtre gnuplot 0 
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(D) 2457670 + 






0.338918, -1.70733 


© Variable Star 











miam (ET a Centre de contrôle de Siril 
- N&B É e Éditic aitement de age Analyse Fenêtre Aide 
Conversion Séquence Pre-traitement Alignement Graphique Empilement Sortie de console 
—— 





Magnitude de l'étoile (relative, utilisez "setmag") 


ad 1 i 4 j 





1590 69959 à.204016 à.218072 024212. | 


x = a Fenêtre gnuplot 0 
A E a a E A 


Courbe de luminosité 











0.24 0.25 0.26 0.27 0.28 0.29 0.3 0.31 0.32 0.33 0.34 0.35 
UD) 2457412 + 
0.240585, -0.325566 








See rphere P154 


1.6. Stacking 


The final step to do with Siril is to stack the images. Go to the "stacking" tab, indicate if you want to stack 


all images, only selected images or the best images regarding the value of FWHM" ET previously 
computed. Siril proposes several algorithms for stacking computation. 
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| Siril uses a 32-bit internal image to process the stacking, which is then saved to a 16-bit image. 


© Stacking a planetary image 


| Siril provide an option to £P automatically align RGB channels P131 at the end of the stack. 


Stacking 


Fileconversion Sequence Pre-processing Registration Plot Stacking Output logs 


Stacking of images, either summing, median, mean with rejection or pixel minimum/maximum. 
Sequence stacking 


Stacking methods Sum stacking vi 


=a A o a M H N A a a e a O a a ep a 
LLL << &#8# | — 
ole with scaling -9 Force recomputing ı 


Store result in file: ae ere G Overwrites 
j a 


Console 


| Type help For the list of supported commands 


Ready. 








Current working directory:/home/laurent/Documents/traitement @stop| | Change dir... 


Current working sequence:-none - Mem: 63MB 14 = +] 








GD Stacking Methods 


Sum stacking ¥ 


Sum stacking 
Average stacking with rejection 
Median stacking 


Pixel maximum stacking 


Pixel minimum stacking 


2 Normalization 
Additive with scaling ¥ 


@ No normalization 
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@ Additive 

© Multiplicative 

@® Additive with scaling 

© Multiplicative with scaling 
©) Force recomputing 


[ | Force recomputing 


By default, Siril takes the normalization coefficients from seq file if already computed. However you 
can force Siril to recompute it before stacking. 


© Stack this set of images 


all the images of the sequence * 


all the images of the sequence 
images previously manually selected from the sequence 


best images, automatically selected from the registration data (PSF) 


best images, automatically selected from the registration data (Planetary) 


O Start stacking 


Start stacking 


Start stacking the current sequence of images, using the method and other information provided 
above. 


© Store result in file: 


| stack result.fit 


Choose a file name 


© Overwrite 
Overwrite 


Overwrite file without notice if it already exists. 
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1.6.1. Stacking Methods 


1.6.1.1. Sum Stacking 


# Sum Stacking 


This is the simplest algorithm: each pixel in the stack is summed using 32-bit precision, and the 
result is normalized to 16-bit. The increase in signal-to-noise ratio (SNR) is proportional to VN, 
where N is the number of images. Because of the lack of normalization, this method should only be 
used for planetary processing. 


Stacking by sum has been parallelized to soeed up deep sky lucky imaging file processing. 


1.6.1.2. Average Stacking With Rejection 


This method is used to reject deviant pixels iteratively. 


Sequence stacking 


Stacking Methods: | Average stacking with rejection hd | 
Normalisation: | Additive with scaling + || _) Force recomputing 
Rejection: 
Winsorized Sigma Clipping + | Sigma low: [4.000 — +) 
Sigma high: [3000 |—| +] 


Five rejection methods have been implemented: 


-= = —— p 


_—— y 


06/08/18 


Percentile Clipping 


This is a one step rejection algorithm ideal for small sets of data (up to 6 images). 


Sigma Clipping 


This ts an iterative algorithm which will reject pixels whose distance from median will be farthest 
than two given values in sigma units(o, OR gh): 


Median Sigma Clipping 


This is the same algorithm than Sigma Clipping except than the rejected pixels are replaced by 
the median value of the stack. 


Winsorized Sigma Clipping 
This is very similar to Sigma Clipping method Sigma Clipping 
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| lt uses an algorithm based on Huber's work 1 [p.200] 5[p.200] 


# Linear Fit Clipping 


lt fits the best straight line (y=ax+b) of the pixel stack and rejects outliers. This algorithm performs 
very well with large stacks and images containing sky gradients with differing spatial distributions 
and orientations. 


This is an algorithm developed by Juan ConejerolP*{, main developer of Pixinsight. 


| This algorithm is very efficient to remove satellite/plane tracks. 


| After pixel rejection, the mean of the stack is computed. 


Normalization 


Siril control center 
Image Processing ‘Scripts Analysis Windows Help 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 
Stacking of images, either summing, median, mean with rejection or pixel minimum maximum. 
Sequence stacking 
Stacking Methods: | Average stacking with rejection 
Normalisatiom | Additive with scaling + || | Force recomputing 


Rejection: 
Winsorized Sigma Clipping + | Sigmalow: | 4.000 


|| Normalise to he Sigma high: | 3.000 


h 


fee Ifyou check this button, the final image will be normalized to 16-bit per channel. 
Stack this is is impo input sequence has a depth of 8-bit per channel. 


Store result in File: | stack_result.Fit ra Overwrite 


Current working directory: fhome/laurent/Bureau/video (@ Stop Change dir... 


Mem 73MB 4 
Disk Space: 227G 


Current working sequence: - none - 
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8-bit image processing 


It's possible to normalise at 16 bits per channel 8-bit images per channel. 


Remember to disable this option during preprocessing, to build your Master Dark, Flats and Bias, 
and to reactivate it to make the final stack. 


1.6.1.3. 


P 


1.6.1.4. 


Median Stacking 


Median Stacking 


This method is mostly used for dark/flat/offset stacking. The median value of the pixels in the 
stack is computed for each pixel. As this method should only be used for dark/flat/offset stacking, it 
does not take into account shifts computed during registration. The increase in SNR is proportional 
to 0.8VN. 


Pixel Maximum Stacking 


Pixel Maximum Stacking 


This algorithm is mainly used to construct long exposure star-trails images. Pixels of the image are 
replaced by pixels at the same coordinates if intensity is greater. 


Pixel Minimum Stacking 


Pixel Minimum Stacking 


This algorithm is mainly used for cropping sequence by removing black borders. Pixels of the image 
are replaced by pixels at the same coordinates if intensity is lower. 


1.6.2. Normalization 


If one of these items is selected, a normalization process will be applied to all input images before 
stacking. 


Normalization matches the mean background of all input images, then, the normalization is processed by 
multiplication or addition. 


Keep in mind that both processes generally lead to similar results but multiplicative normalization is 
preferred for image which will be used for multiplication or division as flat field. 


Scale matches dispersion by weighting all input images. 


This tends to improve the signal-to-noise ratio and therefore this is the option used by default with the 
additive normalization. 
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1O) 


The offset and dark masters should not be processed with normalization. 
However, multiplicative normalization must be used with flat-field frames. 


Possible values 

@ No normalization 
Additive 
Multiplicative 
Additive with scaling 


Multiplicative with scaling 


1.7. Sequence export 


Siril can export sequences in the following formats: 


èe FITS 

© SER 

e AVI 

@ MP4 

èe WEBM 
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In images sequences tab 





Siril control center 


File conversion Image sequences | Pre-processing Registration Stacking Output logs 


Images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out. 


Sequence selection 


Sequence: v Search sequences 


(| force .seq recomputation 


Image selection in sequence 

















No sequence 

|1 — + | [| excluded (| reference image 

exclude all include all 
Sequence export 
Base name: | | FITS Export sequence 
SER 
( | Normalize images AVI Select area to crop 
Console WEBM 
| Type help for the list of supported commands 
Ready. 

Current working directory: /media/laurent/LaCie/Irg @Stop | | Change dir... 

Current working sequence:- none - Mem: 64MB 14 = +) 


x Supported export options 
FITS and SER 


Sequence export 


Base name: [ | FITS = | Export sequence | 
| | | | 

















[| Normalize images Select area to crop 
AVI 
Sequence export 
Base name: | | | AMI + | Export sequence | 
[|] Normalize images Fps: | 25.000 | [|] Resize | 620 |x| 480 Select area to crop 
MP4 and WEBM 


Sequence export 
Base name: | | | MP4 + | | Export sequence | 


[ ] Normalize images Fps: | 25.000 | [ ) Resize | 620 |x| 480 j= |— Select area to crop 
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All sequence export options 


User guide 


Siril control center 


File conversion Image sequences | Pre-processing Registration 


| Sequence: 





| No sequence 
| 4 


exclude all 


include all 


Stacking Output logs 


Images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out. 


Sequence selection 


v Search sequences 


( ) force .seq recomputation 


Image selection in sequence 


(| reference image 











Console 


| Type help For the list of supported commands 


Current working directory:/media/laurent/LaCie/lrg 


Current working sequence:-none - 


B Sequence export 
| Base name: — v | 


Resiz 


Ready. 





@stop | | Change dir... 


Mem:64MB l4 


Export sequence 


NS RS | 
9: 20 480 © ETR area to crop ı 
if 


2 











Base name: | 


Base name 


Base name for the exported sequence 


MP4 + | 


Export sequence format. 


è FITS 
© SER 

e AVI 

@ MP4 

èe WEBM 
& 


| MP4 and WEBM replaces GIF for modern Web publication 


A 
| AVI is not compressed. 
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[ | Normalize images 


Normalize images 
Activate image normalisation for the export. 


This will make all images the same brightness and is thus recommended for sequences with 
inconsistent exposures or pixel values. 


A first computation pass will be done on all images before exporting, it may take some time, only 
_ the first export of a sequence. 


Fps: | 25.000 


Frame rate 
In frames per second 


[ | Resize 


Resize 
Check this box if you want to resize exported sequence. Note that this will degrade image quality. 


620 


Width of output video 
In pixels 


480 


Height of output video 
In pixels 


© 


4 mn —— 


Film quality: 
Lower value will use more compression and less bit-rate, also resulting is smaller file size. 
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Select area to crop 


Select area to crop 


You can crop and normalize sequence images 


Q 
| 


1.8. Available commands 


Reference list of available commands. 


This manual is a summary of the different commands you can find in Siril. 


Automatic processing 


With a text file 


© It's possible to perform automatic processing 
Write command in a file, one command per line 
save the file filename 


then load it in the console with @£ilename 


The <SPACE> character is the delimiter between arguments. If you need to have spaces inside the 
arguments, you can use the quote or double quote, just like in a shell. 


With a script 


Since version 0.9.9 you can create your custom scripts. 


_ For their use see the scripting section. 


© Sample script for preprocessing DSLR images 
HR RER RER 
# Script for Siril 0.9.9 
# April 2018 
# (C) Cyril Richard 
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# DSLR_preprocessing v1.1 

HHHHHHHHHHH PREPROCESSING SCRIPT #######4###4 
# Script for DSLR color camera preprocessing 

# needs 4 sets of RAW images in the working 

# directory, within 4 directories: 

# biases, flats, darks and lights 

# 

PEPER AGAR EEEAE TEESE EES SESE PET 
#build master-bias 

cd biases 

convertraw bias _ 

stack bias_ rej 3 3 -nonorm 

Cd .. 

cd flats 

#preprocess flats 

convertraw flat_ 

preprocess flat_ -bias=../biases/bias_ stacked. fit 

#build master-flat 

stack pp_flat_ rej 3 3 -norm=mul 

cd.. 

#build master-dark 

cd darks 

convertraw dark _ 

stack dark_ rej 3 3 -nonorm 

cd.. 

#preprocess lights 

cd lights 

convertraw light_ 

preprocess light_ -dark=../darks/dark_stacked.fit -flat=../flats/pp_flat_stacked.fit -cfa -debayer 
#align lights 

register pp_light_ 

#stack calibrated lights 

stack r_pp_light_ rej 3 3 -norm=addscale 

#That's a workaround here to save result in another place. 
#These lines are not mandatory 

#load image in memory 

load r_pp_light_stacked.fit 

#Compute noise 

bgnoise 
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Hand save it at root 


cd.. 


save result.fit 


close 


© Download the latest version 


| https://free-astro.org/svn/siril/oranches/0.9/scripts/DSLR_preprocessing.ssf 


You can 


x 





use the commands directly in the console 


Siril control center 
Help 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 


This conversion tab is used to import files and convert them into a format with which Sint can work: FITS or SER. 


Source 


Colour image target 
(=) Keep three channels 


° Create three images 
| Demosaicing 


\ Keep only First channel 


. ! BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, SER 
TT sequences, TIFF images, JPG images. 


Typing ‘help’ here will bring the list of supported commands. 


Current working directory: /home/laurent/Bureau/video ə Stop Change dir... 


Current working sequence: - none - i u a 4 
Disk Space: 227G 


| The help command directly explains the syntax to use. 


Q Since version 0.9.9 self-completeness is active in the console 


When you enter a command in the console, an order list is proposed according to your input: 
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Siril control center 
Image Processing ‘Scripts Analysis Windows Help 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 


Tiis conversion tab is used to import files and convert them into a format with which Sinl can work: FITS ar SER. 


Source 


Colour image target 
(=) Keep three channels 
(0 Create three images 


[| Demesaicing _ 
° Keep only First channel 


BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, SER 


Supported file types <equences, TIFF images, JPG images. 


Console 


st] k 
clearstar | 
l Findstar 
stack 
€ stackall 


Disk Space: 227G | 








© The instruction command manual 


By clicking on the icon to the right of the console, you access the instruction commands manual: 
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Siril control center 
Windows Help 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 


This conversion tab is used to import files and convert them into a format with which Sini can work: FITS or SER. 


Source 


Colour image target 
(=) Keep three channels 
° Create three images 
| Demosaicing = _ | 
* Keep only First channel 


BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, SER 


Supported file types: sequences, TIFF images, JPG images. 


Console 


Le 


Ready. Displays manual of the command written in the console. 


Current working directory: /home/laurent/Bureau/video oe Stop Change dir... 


Meme: 73MB 4 


Current working sequence: - none - i 
Disk Space: 227G 
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© Manual entry for Stack 


Siril control center 
Image Processing Scripts Analysis Windows Help 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 
This conversion tab is used to import files and convert them into a format with which Sinmi can work: FITS or SER. 


Source 


stack sequencename [type] [sigma low] [sigma high] [-nonorm, norm=] ee ay ee 
Stacks the "sequencename" sequence, using options. The allowed am | 

types are: sum, Max, min, med or median, and rej or mean that requires the | — keep iwe a 

use of additional arguments “sigma low" and "high" used for the on m 

Winsorized sigma clipping rejection algorithm (cannot be changed from Bode es las 

here). Different types of normalisation are allowed: "-norm=add" For Ps | . 

addition, "-norm=mul" for multiplicative. Options "-norm=addscale" and "- Keep only First channel 

norm=mulscale" apply same normalisations but with scale operations. IF no 

argument other than the sequence name is provided, sum stacking is 

assumed -CFA images, Films, SER 


Can be used in a script: YES 


Current working directory: /home/laurent/Bureag/video (@ Stop Change dir... 


Mem: 73MB 4 


Current working sequence: - none - | 
Disk Space: 227G 





Commands list 


You will find below the list of the commands and a description of their use. 


# addmax 


addmax filename 
addmax compute a new image IMG with IMG_1 and IMG 2. The pixel of IMG_1 is replaced by the 
pixel at the same coordinates of IMG_2 if the intensity of 2 is greater than 1. 


Se DO, 


Do not forget to save the result. 


| Can not be used in a script. 


© bg 


| = 
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Returns the background level of the image loaded in memory. 


Q 


| Can be used in a script 


P bgnoise 
bgnoise 
Returns the background noise level. 
Q 


| Can be used in a script 


# cd 


cd directory 
Defined the new working directory 
@ 


Set the new current working directory. directory can contain the ~ token, expanded as the home 
directory, directories with spaces in the name can be protected using single or double quotes. 


© Examples: 


© cd ~/M42 





e cde, elu = 


Q 


| Can be used in a script 


P cdg 


edg 
Return the coordinates of the center of gravity of the image. 


Q 


| Can be used in a script 


®© clear 


clear 


Clears the graphical output logs. 


®© clearstar 


| elle == EM 
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Clear all the stars saved in memory and displayed on the screen. 


| Can not be used in a script. 


®© convertraw 


convertraw basename [-debayer] 


Convert DSLR RAW into Siril's FITS images. 
The argument basename is the basename of the new sequence. 


The option -debayer applies demosaicing to images 


Q 


| Can be used in a script 


®© close 


close 
Closes the open image and the open sequence correctly, if necessary. 
Q 


| Can be used in a script 


P cosme 


cosme filename 

Apply the local mean to a set of pixels on the in-memory image (cosmetic correction). The 
coordinate of this pixels are in an ASCII file [list file]. COSME is adapted to correct residual hot and 
cold pixels after preprocessing. 


The line P x y type will fix the pixel at coordinates (x, y) type is an optional character (C or H) 
specifying to Siril if the current pixel is cold or hot. This line is created by the command find_hot but 


_ you also can add some lines manually. 


Q 
The line C x 0 type will fix the bad column at coordinates x. 
The line L y 0 type will fix the bad line at coordinates y. 


Q 


| Can be used in a script 
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P cosme cfa 


cosme cfa filename 


Same function that COSME but applying to RAW CFA images. 


Q 


| Can be used in a script 


P crop 
Chop, Ar med niente ane 
Crops the current image within the rectangle previously selected. 
Q 


| Can be used in a script 


# ddp 


ddp level coef sigma 


Performs a DDP (digital development processing) as described first by Kunihiko Okanol”tps/www. 


sbig.com/astronomy/hall-of-fame/kunihiko-okano/] 


This implementation is the one described in IRIS. It combines a linear distribution on low levels 
(below level) and a non-linear on high levels. It uses a Gaussian filter of sigma sigma multiplies the 
resulting image by coef. The typical values for sigma are included between 0.7 and 2 


| Can not be used in a script. 


entropy 


chbres 
Computes the entropy of the opened image on the displayed layer, only in the selected area if one 
has been selected or in the whole image else. 


* 


| The entropy is one way of measuring the noise or the details in an image. 


Q 


| Can be used in a script 


®© exit 


SLC 


Quits the application. 
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Q 


| Can be used in a script 


®© extract 


extract NbPlane 
Extracts NbPlane Planes of Wavelet domain. 


Q 


| Can be used in a script 


# div 


fdiv filename scalar 


Divides the image in memory by the image given in argument. The resulting image is multiplied by 
the value of the scalar argument. Please check that the image is in the working directory 


Check that the image is in the working directory. 


TT ®) 


| See also idiv 


Q 


| Can be used in a script 


© fftd 


fftd modulus phase 


Applies a Fast Fourier Transform to the image loaded in memory. Modulus and phase given in 
argument are saved in FITS files. 


Q 


| Can be used in a script 


© ffti 


Pre mous phase 


This function is used to retrieve corrected image applying an inverse transformation. The modulus 
and phase used are the files given in argument. 


Q 


Can be used in a script 
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08 


À fill 


fill value x y width height 
Fills the whole current image (or selection) with pixels having the value intensity. 
Q 


| Can be used in a script 


© fill2 


f1112 value x y width height 

Same command than fill but this is a symmetric fill of a region defined by the mouse. Used to 
process an image in the Fourier (FFT) domain. 

Q 


| Can be used in a script 


P find _cosme 


Ea Ch Comite COs slices, Iniere es Ce 


Applies an automatic detection of cold and hot pixels following the thresholds written arguments 


Q 


| Can be used in a script 


P find _cosme cfa 
ELM VOOSMe ola Ole sales Not sree! 
Same command than find_cosme but for monochromatic CFA images. 
Q 


| Can be used in a script 


# find hot 


find _ hot filename cold sigma hot sigma 

The command provides a file lists "filename" (format text) in the working directory which contains 
the coordinates of the pixels which have an intensity "hot_sigma" times higher and "cold_ sigma" 
lower than standard deviation. We generally use this command on a master-dark file. 


Q 


| Can be used in a script 


© findstar 


ie doers Er 
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Fe. 


Detects stars having a level greater than a threeshold computed by Siril. 


x 


After that, a dynamic PSF is applied and Siril rejects all detected structures that don't fulfill a set 
of prescribed detection criteria. Finally, a circle is drawn around detected stars. See also the 
command clearstar. 


The algorithm is based on the publication of Mighell, K. J. 1999, in ASP Conf. Ser., Vol. 172, 
Astronomical Data Analysis Software and Systems VIII, eds. D. M. Mehringer, R. L. Plante, & D. A. 
Roberts (San Francisco: ASP), 317. 


| Can not be used in a script. 


fmedian 


fmedian ksize modulation 


Performs a median filter of size ksize xksize (ksize MUST be odd) to the original image with a 
modulation parameter modulation. The output pixel is computed as : out =mod x m+(1-mod)xin, 
where m is the median-filtered pixel value. A modulation's value of 1 will apply no modulation. 

Q 


| Can be used in a script 


© fmul 


fmüul scalar 


Multiplies the loaded image by the scalar given in argument. 


Q 


| Can be used in a script 


P fixbanding 


do eyarcleigie MEMOIRE 


Try to remove the canon banding. "Amount" define the amouont of correction. Sigma defines a 
protection level of the algorithm, higher sigma gives higher protection. 


Q 


| Can be used in a script 


®© gauss 


06/08/18 


Gauss, sigma 


Performs a Gaussian filter with the given sigma. 
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Q 


| Can be used in a script 


P help 


help 
Gives the available commands in output logs tab. 


| Can not be used in a script. 


®© histo 


histo layer 


Calculates the histogram of the image layer in memory and produces file histo [layer name].dat in 
the working directory. 


layer = 0, 1 or 2 with O=red, 1=green and 2=blue. 


Q 


| Can be used in a script 


© idiv 
idiv filename 


Divides the image into memory by the image given in argument. 


Divides the image in memory by the image given in argument. Please check that the image is in 
the working directory. 


x 


| See also fdiv. 


| Can not be used in a script. 


© imul 


ImU name 


Multiplies the image in memory by the image given in argument. 


Please check that the image is in the working directory. 
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| Can not be used in a script. 


# isub 


Levey ta eee 


Subsiracts the image in memory by the image given in argument. 


Please check that the image is in the working directory. 


| Can not be used in a script. 


# load 


load filename 

load filename.ext 

Loads the fits image filename; it first attempts to load filename, then filename.fit and finally filename. 
fits and after, all supported format, aborting if none of these are found. These scheme is applicable 
to every Siril command implying reading files. Fits headers MIPS-HI and MIPS-LO are read and 
their values given to the current viewing levels. 


Writing a known extension at the end of filename will load the image filename.ext: this is used 
when numerous files have the same name but not the same extension. 


Extensions supported are : 
© fit, “.fits, *.fts 
bmp / *.jpg, *.jpeg / *.png / “tif, *.tiff 


© 
© ppm, *.pgm 
@ pic (IRIS file) 


Q 


| Can be used in a script 


P log 


LO 
Computes and applies a logarithmic scale to the current image. 


Q 


Can be used in a script 
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À is 


Is 
This command lists files and directories in the working directory. 


| Can not be used in a script. 


®© mirrorx 


MEEO CK 


Rotates the image around a vertical axis. 


Q 


| Can be used in a script 


P mirrory 


MITOY 


Rotates the image around an horizontal axis. 


Q 


| Can be used in a script 


© new 


new width height nb _ layers 


Creates a new image filled with zeros with a size of width x height. The image is in 16-bit format, 
and it contains nb layers layers, nb layers being 1 or 3. 


| lt is not saved, but displayed and can be saved afterwards. 


Can not be used in a script. 


P nozero 


nozero jewel 


Replaces null values by level values. Useful before an idiv ou fdiv operation. 


Q 


Can be used in a script 
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®© offset 


offset value 


Adds the constant value to the current image. This constant can take a negative value. As Siril uses 
unsigned fit files, if the intensity of the pixel become negative its value is replaced by 0 and by 
65535 (for a 16-bit file) if the pixel intensity overflows. 


Q 


To check the minimum and maximum intensities values, click on the Auto level button and note 
the low and high threshold. 


Q 


| Can be used in a script 


© preprocess 
Sse MeOCS SE RSeUeneSnemeNISnNeSS dark MSC MIS ER Ven 
te] 
Preprocess the sequence sequencename using bias dark and flat given in argument. It's 


possible to specify if images are CFA for cosmetic correction purposes with the option -cfa and 
also to demoisaic images at the end of the process with -debayer. 


The -flip options tells to Siril to read image from up to bottom for demosaicing operation. 


Q 


| Can be used in a script 


P psf 


Poi 
Make a selection around a star and call the command PSF. It will give you: 


@ [he centroid coordinates (xO and yO) in pixel units, which is the position of the center of 
symmetry of the fitted PSF. 


@ The FWHM on the X and Y axis. 

® The rotation angle of the X axis with respect to the centroïdel”#Ps//"ww.oqli.gouv.qc.ca/ressources 
/bibliotheque/dictionnaires/terminologie_geomatique/centroide.html] coordinates. 

@ The average local background. 


The maximal intensity of the star: this is the peak value of the fitted function, located at the 
centroid coordinates x0 and y0. 


The relative magnitude of the star. 


The RMSE. This is an estimate of fitting quality. The smaller the RMSE is, the better the 
function Is fitted. 
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To be relevant, the selection MUST be done on a non-saturated star. 


| Can not be used in a script. 


P register 


register sequence [-norot] [-drizzle] 

Effectue des transformations géométriques sur les images de la sequence donnée en l'argument 
afin qu'elles puissent être superposée a l'image de référence. Le nom de la séquence de sortie 
commence par le préfixe r_. Utilisant des étoiles pour l'alignement, cet algorithme ne fonctionne 
qu'avec des images de ciel profond. L'option =norot effectue une translation seule avec aucune 
création de nouvelle sequence alors que l'option -drizzle applique un drizzle x2 sur les images. 
Q 


| Can be used in a script 


P resample 
resample factor 
Resample image with a factor factor 
Q 


| Can be used in a script 


Pil 


rl iterations sigma 


Restore an image uing the Richardson-Lucy method. iterations is the number of iterations to 
be performed (typically between 10 and 50). sigma is the size of the kernel to be applied. 
Q 


| Can be used in a script 


# rmgreen 


Me Lee Eire 

rmgreen is a chromatic noise reduction filter. It removes green noise in the current image. This filter 
is based on Pixinsight's SCNR Average Neutral algorithm and it is the same filter used by HLVG 
plugin in Photoshop. In command line, the lightness is always preserved. For image processing 
without L* preservation use the graphical tool box and uncheck the corresponding button. 


Q 


Type =1 stands for Average Neutral Protection, while type=2 stands for Maximum Neutral 
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| Protection. 


Q 


| Can be used in a script 


# rotate 


rotate degree 


Rotates the image of an angle of degree value. 


This function requieres the installation of libopencv. 


Q 


| Can be used in a script 


P rotatepi 


rotatepli 


Rotates the image of an angle of 180° around its center. 
@ 


| This is equivalent to the command rotate180 or rotate -180. 


Q 


| Can be used in a script 


P satu 


Satu coeff 


Enhance the global saturation of the image. 


Q 


_ Try iteratively to obtain best results. 


© 


For exemple: Satu 0,1 


Q 


| Can be used in a script 


P save 


| Saver nane 
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Save current image to filename.fit. Fits headers MIPS-HI and MIPS-LO are added with values 
corresponding to the current viewing levels.. 


Q 


| Can be used in a script 


P savebmp 


savebmp filename 
Save current image under the form of a bitmap file with 8bits per channel: filename.omp (BMP 24 
bits). 


Q 


This function is like a screenshot of what you see with the levels updated. This is very usefull to 
share an image in the bitmap format. 


Q 


| Can be used in a script 


P savejpg 


savejpg filename [quality] 

Save current image into a JPG file. You have the possibility to adjust the quality of the compression. 
A value 100 for quality parameter offers best fidelity while a low value increases the compression 
ratio. If no value is specified, it holds a value of 100. 


This function is like a screenshot of what you see with the levels updated. 


* 


_ If no value is specified, it holds a value of 100. 


| This command is very useful to share an image in the jpeg format on the forums for example. 


Q 


| Can be used in a script 


# savepng 


savepng filename [quality] 


Save current image into a png file. 


Q 


| Can be used in a script 
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# savepnm 


savepnm filename 


Save current image under the form of a Netpbm file format with 16bits per channel. The extension 
of the output will be filename.ppm for RGB image and filename.pgm for gray-level image. 


* 


| More details about the Netpbm format here/http.//en. wikipedia.org/wiki/Netpbm_format] 


Q 


| Can be used in a script 


# savetif 
savetif filename 
Save current image under the form of a uncompressed TIFF file with 16bits per channel. 
Q 


| Can be used in a script 


®© savetif8 


savetifs filename 
Same command than savetif but the output file is saved in 8bits per channel. 
Q 


| Can be used in a script 


®© select 


select from to 


This command allows easy mass selection of images in the loaded sequence (from - to, to 
included). 


© 


select 0 QO 
selects the first. 


select 1000 1200 
selects 201 images starting from number 1000 


The second number can be greater than the number of images to just go up to the end. 
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| Can not be used in a script. 


© seqcrop 


seqcrop 


Crops the loaded sequence. 


| Can not be used in a script. 


P seqfind_cosme 


seqfind_cosme sequencename cold_sigma hot_sigma 


Same command than find_cosme but for the sequence sequencename. 


Q 


| Can be used in a script 


P seqfind cosme cfa 


seqfind_ cosme cfa sequencename cold _ sigma hot _ sigma 


Same command than find_cosme_cfa but for the sequence sequencename. 


P seqpsf 


seqpstf 
Same command than PSF but for the sequence. 


Q 


Result are dumped in the console in a form that can be used to produce brightness variation 
curves. 


| Can not be used in a script. 


®© setcpu 


setcpu number 

Defines the number of processing threads used for calculation. Can be as high as the number of 
virtual threads existing on the system, which is the number of CPU cores or twice this number if 
hyperthreading (Intel HT) is available. 
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Q 


| Can be used in a script 


© setext 


Jere Esc eine Lom 


Sets the extension used and recognized by sequences. The argument "extension" can be "fit", "fts" 
or "fits". 
Q 


| Can be used in a script 


®© setmag 


setmag magnitude 
Defines the magnitude constant by selecting a star and giving the true magnitude. All PSF 
computations will return the true magnitude after this command. 


_ To reset the magnitude constant see unsetmag_. 


| Can not be used in a script. 


© setmagseq 


setmagseq magnitude 
This command is only valid after having run segpsf or its graphical counterpart (select the area 
around a star and launch the psf analysis forthe sequence, it will appear in the graphs). 


This command has the same goal as setmag but recomputes the reference magnitude for each 
image of the sequence where the reference star has been found. 


Q 


When running the command, the last star that has been analyzed will be considered as the 
reference star. 


Displaying the magnitude plot before typing the command makes it easy to understand. 


| To reset the reference star and magnitude offset, see unsetmagseg. 


| Can not be used in a script. 


06/08/18 Version : 1.53 The free-astro development team, 2018 Siril 0.9.9 69 


Siril functions User guide 


P split 


soli ic GS 

The command splits the color image into three distincts files (one for each color) and save them in r 
g and b file. 

@ 


| Can not be used in a script. 


®© stack 


stack segquencename [type] [sigma low] [sigma high] [-nonorm, norm=] 
Stack the sequence sequencename , using options. 


The allowed types are: sum, max, min, med ,median, and rej or mean mean that requires the 
use of additional arguments sigma low and sigma high used for the Winsorized sigma 
clipping rejection algorithm (cannot be changed from here). 


lf no argument other than the sequence name is provided, sum stacking is assumed. 


No image filtering of the sequence is applied: all are selected to be stacked. 


& 
Different types of normalisation are allowed: —norm=add for addition, -norm=mu for 
multiplicative. 


Options -norm=addscale and —norm=mulscale apply same normalisations but with 
scale operations. 


1O) 


The stacked image sequence is created with the "_stacked" suffix and the configured FITS file 
extension. 


| This command has been added since version 0.9.9 


1O, 


| Can be used in a script 


P stackall 


stackall [type] [sigma low] [sigma high] [-nonorm, norm=] 


Opens all sequences in the CWD and stacks them with the optionally specified stacking type or with 
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sum stacking. See STACK command for options description. 


Q 


| Can be used in a script 


© stat 


SEAC 


Returns global statistic of the current image. If a selection is made, the command returns global 
Statistic within the selection. 


Q 


| Can be used in a script 


# _threshlo, threshhi, thresh 


These are threshold functions: 
@ threshlo 40 replaces values below 40 with 40; 
@ threshhi 1000 replaces values above 1000 with 1000; 


®© thresh 40 1000 does both. 


Q 


| Can be used in a script 


P unselect 


unselect from to 


This command allows easy mass unselection of images in the loaded sequence (from - to). 


Q 


| See select. 


| Can not be used in a script. 


P unsetmag 


HSE EME) 


Reset the magnitude constant to 0. 


Voir setmag 
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| Can not be used in a script. 


P unsetmagseq 


Reset the magnitude calibration and reference star for the sequence. 


Can not be used in a script. 


P unsharp 
Ga sliene Salen: amelie aL 
Applies to the working image an unsharp mask with sigma sigma and coefficient multi. 
Q 


| Can be used in a script 


®© visu 


visu low high 
Displays an image with low and high as the low and high threshold. 
@ 


Can not be used in a script. 


®© wavelet 


wavelet plan_number type 


Computes the wavelet transform on plan_number plans using linear (type=1) or bspline (type=2) 
version of the 'a trous' algorithm. The result is stored in a file as a structure containing the planes, 
ready for weighted reconstruction with wrecons. 

Q 


| Can be used in a script 


P wrecons 


WicS@OmS > Cl Vez we. CM 
Reconstructs to current image from the planes previously computed with wavelet and weighted with 
coefficients c1, c2, ..., cn according to the number of planes used for wavelet transform 


Q 


Can be used in a script 
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1.9. A powerful astronomy image viewer 


A Display Mode viewer is used to improve the visibility of an image. 


| Without altering its pixel data in any way, similarly to what DS9"°-*°"! scale does. 


The grey window is used to display color components for the image, 
control their visual composition in the color image, 


and give information about the displayed frame, 


pixel value when moving the mouse on a pixel, 


Affichage de la valeur du pixel 


@ file name and layer number, 


zoom value, 


FWHM P'É1 value of the selection if it applies, 


and some display tools. 


The display modes allow the scaling of the source image file to the displayed image to be changed. 
sliders and display modes are used to improve the visibility of some details in an image, or more 
precisely to change the dynamics of the viewing, without altering pixel data from the image file in any 
way. This is only for display purposes. 
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siril-0.9 





qf 
15 D x: 1971 y: 0011 = 1735 test _00018.fit (channel 0) vhm: no selection 1 





MIPS-LO/HIË 


i 
“er "7" 


SEE Le FELY A: : ee) 


ae ul 





Rotate 90° counter clockwise 


© Rotate 


+. ai 


Rotate 90° clockwise 


© Mirror 
C.. 
p 


Horizontal mirror 


© Mirror 
Ak 


Vertical mirror 
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@ Histogram 


Lu 


Open/close rrhistogram toolbox !?-*4! 


© List of images 


Show/hide plist of images P78! in the sequence with registration data ep P84 


7 Negative view 


rl? Colors maps viewer !P-79l p [P-84] 





© False color rendering 





Switch to normal and rainbow color map £P Colors maps viewer !?-’9! gp [P-84] 


© Display modes 


Linear T 


The different display modes 


@) Zoom 


zoom to fit + 


Zoom level 


@) MIPS-LOHI 
(Ò MIPS-LO/HI 


If this option is checked Fits headers MIPS-HI and MIPS-LO are read and their values given to the 
current viewing levels. 
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User is the values defined by the user. As soon as you touch the sliders, it uses user mode. 


©) fwhm value 


Fwhmi: no selection 


see r?statistics [P107 


D Channel 


Red channel Green channel Blue channel 





Displayed channel 


@® sliders 


[1 cut 





Ol 65535 | 


SS O A A", 





The sliders at the bottom control thresholds for black and white on the grey image, allowing to play 
with contrast and lightness of each channel separately or together, depending if the chain button is 
checked or not. 


B 
The sliders are disabled when Histogram or AutoStretch display modes are used. 


The different display modes 


P linear 


the default mode of Siril. The pixels are displayed from dark to light in a linear scale. 





P Logarithm 


The logarithmic scale. The operation simultaneously exacerbating the weak and light levels of the 
image. 
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P Square root 


The square root of each pixel. This can be seen primarily in this mode are the brightest parts of the 
image. 





Square of each pixel. Which can be seen with this model viewer is primarily the most brightest part 
of the image. 





© Asinh 


The inverse hyperbolic sine is commonly used, it reproduces the perceptive capacity of the human 
eye, allowing to perceive significantly different brightness levels simultaneously. The asinh function 
is close to the logarithmic mode but has a better behavior around zero. 





Æ AutoStretch 


Siril performs auto stretching curves to adjust the image and make it visible on the screen. 





P Histogramme 


The histogram equalization increases the contrast of the image by increasing the dynamic range of 
the intensity given to the pixels with the most likely intensity values. 


It is highly recommended to evaluate all the signals contained in the image. 
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© cut 


W Cut 


Instead of keeping pixels with values greater than the value "hi" white when checked: displays black 
pixels when saturated 


All of these modes can also be applied independently on each channel when the bond inter channel 
is disabled. 


1.9.1. Images list 


9 0 0000006 
SRS EERE EE 
RSBREBESSY 


RAM 
383238 
AE 
$38 





PPRPR PR ERE RE RE RE RE RE Ee 
SIE ES SSE ay ey 
BERSESSESESSSSSESESSSEEES 
SMM MMH HAHARRRAAAKRARARAAABMICBAAARAAAARRAAG 


Be td 8 a 
an D D À © © ® NN à D à D À À Soa Ts 
D À D 2 2 2 2 À + à à à à 2 2 2 2 2 2 2 
Ra Ra Re RP ea RRP RRA ARBRE À 





Show / hide the image list 


List images of the sequence, with their status and quality information. 


Q 


| Sort images by clicking on the title of their column, for example by names, by the FWHM or quality. 


Quality is FWHMEP 13%! when PSF registration is used, so lower is better 


And gradient estimator for DFT/Ps:/en. wikipedia. org/wik/Cross-correlation] registration, higher is better. 
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| Columns X and Y are the translation in pixels relative to the reference image 
1.9.2. Colors maps viewer 
Siril provides different color map viewer, including rendering false color. 


Negative view 


siril v0.9.4 - /home/laurent/Documents/traitement 





Red channel | Green channel | Blue channel 


n + è 
# 1 P š a a - #8 os “ - = = a r 








Green x: 3217 y: 0667 = 010 andromède07-1 6.jpg (channel 1) __ Fwhm:no Re 
M cut 0 Min/Max 

| MIPS-LO/HI 
M = 255 User 


=a ip — AX LL, oe Eu AutoStretch + Zoom to fit + 


06/08/18 Version : 1.53 The free-astro development team, 2018 Siril 0.9.9 79 


Siril functions User guide 


= RVB image negative view 


RGB image 
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Rainbow color-map (false color rendering) 





siril v0.9.4 - /home/laurent/Documents/traitement 





Red channel | Green channel Blue channel 








Green x: 3283 y: 1013 = 000 androméde07-16.jpg (channel 1) Fwhm: no selection 





a gut 255 ii Min/Max 
MIPS-LO/HI 
= : 0 User 
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S RVB image false color rendering 


RGB image 
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Negative view + Rainbow color-map 






siril v0.9.4 - /home/laurent/Documents/traitement 
Red channel (Green channel Blue channel 





Green x: 3281 y: 0582 = 007 androméde07-16.jpgq (channel 1 Fwhm:noselection | 








(C cut ©) 0 © Min/Max 
K (_) MIPS-LO/HI 
Ge | 255 ©) User 


al ic — AX LL, oe [1 | AutoStretch + | | Zoom to fit ¥ | 
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S RVB image Negative view + false color rendering 


RGB image 





1.9.3. Histograms 


You have to stretch the histogram playing mainly on mid-tones and shadows (rarely highlights). 


x 


The mid-tones stretch, while the shadows reposition the histogram to the beginning, to not have a too 
clear sky. 


A 


| Avoid having too much loss of pixels because it is losing information. 


Q 


The icon with the toothed wheel allows to transform the histogram in the same way as does the 
autostetch. 


Usually it gives good stuff, but sometimes it clips too many pixels. 
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Histogram 


adows: 0.0000000 
ights:  1.0000000 





1.9.4. Right click functions 


Red layer 


PSF 
Pick a Star 


Statistics 


Crop 





| Red x: 0519 y: 0303 = 062 lune5.jpg (layer 0) fwhm = 0.00, r = 0.00 


°) Min/Max . 
Lal = 


User 


a 0 Linear ~ D og Zoom to fit + 


The following functions are accessible 
@ Undo: Cancel last operation processed. Warning, does not work with command line functions 


@ Redo: Restore last operation canceled. Warning, does not work with command line functions 


PSF and Pick a Star (see £P Photometry {P-1001 
Statistics: Show all computed statistics 


Crop: Crop the image from selection 


Crop sequence: crop the image sequence from selection 


1.9.5. Display use 


The images below picture the result in Siril using the Auto-Stretch rendering mode. 
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x 


Note the improvement of the signal-to-noise ratio regarding the result given for one frame in the 
previous step (take a look to the sigma value). 
The increase in SNR is of 21/5.1=4.11*1V12=3.46 and you should try to improve this result adjusting 


Slow ANd Ob igh 


Statistics 


GREC CES 


DCHALE#S ocrA kh O FB 





1.10. Image Processing 


1.10.1. Background extraction 








Background Extraction x 
Type of Extraction N 
== Interpolation à 
Manual +) Automatic Clear 
teem e ee ee ee 2S ee ee L — 
# Draw boxes 
errs Generation ~~ LL © prés ER NE ed a 
Box radius: 50 — + |# Degree Order: £ v : 
Se RS = Ou errr eee eee = = = 
Box separation: 5 — + |, Correction 
SSSR 3 (+) Show Image 
al Relection ........--- : 
Tolerance: CAUER ; () Show Background 
lobalRejection. . .-------- Q | 
Deviation: 2.000 — + SSIS l 
nbalance: 1.800 — + |! 
Compute Apply 





Close 





_) Manual 


You must click on the image to choose your own background samples. 


= 
The only parameters are the sample size (box radius ) and degree of order (degree Order) 
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© Automatic 
© Automatic 
Siril take background samples automatically, with the parameters: 
@ sample Generation 
e local Rejection 


@ Global Rejection 


© Box radius 


Box radius: 50 — + 





Radius of the sample area 
Pixel Radius of a background sample area. Multiply by 2 to get the length of the zone. 


© Box separation 
Box separation: 5 = + 
Distance between zones 


Distance in pixels between two adjacent zones of background sample. 


© Tolerance 


Tolerance: 1.500 — + 


Parameter that indicates the local tolerance of the sample rejection in sigma units. 


© Deviation 


Deviation: 2.000 — + 





Deviation 
Parameter that indicates the overall tolerance of the sample rejection in sigma units. 


€ Unbalance 


Unbalance: 1.800 — + 


The factor is multiplied by the deviation parameter to include more dark pixels in the background 





evaluation. 
©} Degree Order 
Degree Order: -= v 


Choose the degree of order of the polynomial used in the adjustment. 


The default value is 4. 
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The higher the degree of order, the greater the gradient can be suppressed. 


© Correction Type 


Subtraction + 


Choose the type of correction you want to apply: 

Subtraction: It is mainly used to correct additive effects such as gradients caused by light pollution 
or the Moon. 

Division: It is mainly used to correct multiplicative phenomena such as vignetting or differential 
atmospheric absorption for example. However, this type of operation must be performed for the 


correction of @pmaster-flat P1221 


1.10.2. Median filter 


Median Filter x 





, Modulation: ee |] 00: 


© Kernel Size 


Kernel Size: jẹ | 3x3 + | 
Odd pixel size of the neighborhood of each pixel. 


® possible sizes 
e 3x3 
5x5. 

7x7] 











© © © © + Ọ 
CO 
>< 
CO 








® Modulation 


Modulation: — |) 1.00 


Modulation parameter defined in the range [0.1]. 
When this setting is 1, no modulation is applied. 
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If the parameter is null no filter is applied. 


© Iterations 


Iterations: 1 + | 
Number of iterations of the algorithm. 


This is useful when the modulation parameter is different from 1 to help the whole process to 
converge to a better result. 


1.10.3. Reducing green tint in processed images 


Subtractive Chromatic Green Noise Reduction 


Subtractive Chromatic Green Noise R.. X 





© Protection method 


Protection method: | Average Neutral + | 


Average Neutral Protection is the default option. This is suitable in most cases. 


æ Possible values 


Average Neutral 





Maximum Neutral 





Maximum Mask. 


Additive Mask 





2) Luminance 


(w Preserve lightness 


Preserves '°:'86 original CIE L*!°:'8°! component of the processed image. 
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1.10.4. Color saturation 


Color saturation x 





M Preserve background 


| Close | Apply | 


© Color 


Global hai 


Pink-Red / Red-Orange 
Orange-Brown / Yellow 
Yellow-Green / Green-Cyan 
Cyan-Blue / Blue-Magenta 
Magenta / Pink 

Global 


© Amount 


Amount: 








0.00 


A value of 0 means no change, the negative values reduce color saturation, positive values increase 
them. 


1.10.5. Banding Reduction 


Banding'®'®*! Reduction 
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Banding Reduction x 











Amount: — ) » 1.00 


(I Protect from Highlights 











1/Sigma Factor = ) 100 
Lever 
| 
| Close | Apply 





|_] Vertical banding 


Check this box if the banding'*'®! is vertical. 


Z Apply to sequence 


If a sequence is loaded and this function is activated, performs processing on all images of the 
sequence instead of the single image loaded. 


Output prefix: | unband_ | 








Prefix of unband images names 


| The canon banding removal tool can be also used on vertical banding noise. 


06/08/18 Version : 1.53 The free-astro development team, 2018 Siril 0.9.9 91 


Siril functions 


1.10.6. Deconvolution 


Ei Siril control center 
File Edit Analysis Windows Help 


File co listogram Transformation... processing Registration 


16:33: Color Calibration... <imum for stacking 
16:33: Ne 

16:33: ANCIEN the sequence (8) 
16:33: Color saturation... Jaaa 

16:33: [31 66607.fit, 
16:33: A trous Wavelets Transform... 31 86001. fit, 
16:33: S 131 90005. fit, 
16:33: D SEEN TEEN [31 80603.fit, 
16:33: Cosmetic Correction. 31 689682.fit, 
16:33: [31 80008. fit, 
16:33: 31 00006. fit, 
16:33: ourier Transform... 31 90004. fit, 
16:33: tadan Filta eeded. 

16:33: pce 

16:33: 

16:33: LS ... normalized sum 
16:33: 2. none 

(16:33: fackground Extraction... ... none 

16:33: Siren none 


layer(s), 5208x3476 
laver(s), 5208x3476 
laver(s), 5208x3476 
laver(s), 5208x3476 
laver(s), 5208x3476 
layer(s), 5208x3476 
Layer(s), 5208x3476 
Llayer(s), 5208x3476 


Kat kad Ed Lg et Lu Lu Lu 


16:33: RGB Compositing... 

16:33:45: Background noise value (channel: #6): 21.776 (3.323e-64) 
16:33:45: Background noise value (channel: #1): 32.595 (4.974e-64) 
16:33:45: Background noise value (channel: #2): 227.058 (3.366e-04) 











Console 


Type help For the list of supported commands 


Sequence processing succeeded. 


Current working directon: fhome/laurent/Moodle Siril/m31 


Current working sequence: r_r_M31_, 8 images selected 


Deconvolution 


Since version 0.9.8 a deconvolution algorithm 
93Lucy deconvolution] has been added 


92 06/08/18 Version : 1.53 


pixels 
pixels 
pixels 
pixels 
pixels 
pixels 
pixels 
pixels 


sL ODELA > 
16:33: Bl stacked.fit, 3 layer(s), 5208x3476 pixels 


1@ Stop) | Change dir... | 


+ 


Mem: 43MB 
Disk Space: 3826 





[https://en.wikipedia.org/wiki/Richardson%E2%80% 


The free-astro development team, 2018 
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1.10.7. RGB compositing... 


Image compositing x 





Multi-layer image composition 


Layer alignments 





















































(J use Luminance | (None) (not loaded | 0 

~ (None) i | not loaded | 0 

- (None) Dil notloaded|O = 
= wi (None) D not loaded | 0 
— _ 





ass. O onu = - ee ee 
a layers brightness ” par colour balance 4 9: composition v | 
p: TEE 





5} | Clear | Close | 
1 
: i 


i and using this alignment method: | One star registration (deep-sky) v 


An image area must be selected for align Crop image to common area after align | 





@ Brightness Adjustment Layers 


| Adjust layers brightness | 








Automatically adjust the brightness of the colors chosen for the layers so that they do not saturate 
the compositing (based on the max value for each image). 


D 
| The color shades are unchanged. 


@) Finalize the color balance 


| Finalize colour balance | 








Opens the RGB calibration tool on the resulting image. This will alter the resulting image in a 
destructive way to align the three channels thereof. 


Changing the settings in this window after cancels the color balance: it must be redone. 


© Type of color composition 


| HSL composition v | 








Type of color composition based on luminance. They are the way to add color information for the 
luminance data. 


® Possible values 
HSLP% composition 
HSV'*'9"l composition 


CIELABP-'É composition 
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O Warning 


WARNING: You should not perform a LRGB combination with linear images. Process images before. 


You should not make a LRVB combination with linear images. Treat first images. 


© Automatic alignment 


and using this alignment method: | One star registration (deep-sky) z 








Align | 





Automatic alignment using the selected method. 


® Possible values 
Image pattern alignment (planetary/deep-sky) 
One star registration (deep-sky) 


For LRGB composition, the reference layer must be luminance. 


© Color selection 
[E 








Dialog box [Select a Color 


Select a Color 











a 
| nt for true colour rendering, « | H-alpha hd 





select a filter from the list or 
enter a visible wavelength in nm 





Alternatively, for true colour rendering, 
select a filter from the list or 
enter a visible wavelength in nm 


B 
For true color rendering, select a filter from the list or enter a visible wavelength in nanometers. 
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656.28 
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Enter a wavelength value in nanometers here, between 380 and 780, the decimal values are 
accepted. 


1O) 


The LRVB alignment does not take into account rotation. 
To work around the problem create a sequence with LRVB image_01, Image 02, etc .... 


Then you align the sequence globally. New aligned files will be created that you can easily integrate 
into the LRVB alignment 


1.10.8. Extraction 
1.10.8.1. Channel extraction 


The Channel extraction allows you to obtain individual RGB pixel channels as grayscale FIT images. 


* 


| Channel extraction does not modify the image to which it is applied. 


It can only be applied to color images. 


Supported color spaces 
RGB? 1%) 

HSLIP1901 

HS 1911 

CIE L*A*B*IP91 


Q 
| 


Select a color space to extract one or more channels or components. 


_ Default, is the RGB color space. 
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Channel Extraction x 
_sesese i 

Color Space: . RGB Za 
2 a Eux F 
ees se ee 1 
hannel #1 r 

o SA cea 
hannel #2 ; 

I I 
S o E 
hannel #3 ; 

[| a I 
| Close | Apply | 


@ Color space 


| RGB ~ | 
Select the color space for the three images from 


> 
Possible values: 


RGB 
see 
HS1 
CEL a p rs 


E) Channel #1 


Channel #1: | 


Name the first FITS file for backup. 


© Channel #2 


Channel #2: | | 


Name of the second FITS file for backup. 


© Channel #2 


Channel #3: | | 


Name of third FITS file for backup. 
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1.10.8.2. Wavelets 


Wavelets extraction layers 


Wavelets Layers Extraction x 


1 
Nb. of Layers: mag 
Interpolation Algorithm: | BSpline + | 
| Close | Apply | 
in a 
Number of Layers 
1.10.9. Cosmetic correction 
Cosmetic Correction x 
ge: detection 
Z Cold Sigma: ' 1300 — +. 
"iM Hot Sigma: " | 3.00 | + | 
Amount: | 1.00 








M Cold Sigma: 


How many times (in average deviation units) the pixel value must be different from the value of its 
surrounding neighbors to be considered a cold pixel. 


M Hot Sigma: 


How often (in mean deviation units) the pixel value must be different from the value of its 
surrounding neighbors to be considered a hot pixel. 


C] CFA 
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Check if the target layers are CFA images? '#]. 


Uncheck if the images are from a monochrome sensor. 





w Apply to sequence 


If a sequence is loaded and checked, performs processing on all images of the sequence instead of 
the single image loaded. 


Output prefix: | cc_ 


Prefix image names resulting from aesthetic correction process. 


1.10.10. Sequence crop 


Crop sequence 


Crop sequence x 








Output prefix: 


prefix of the resulting sequence of the cropping process. 
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1.11. Analysis 








File conversion Image sequences 


Statistics... 


Images are manip 


Sequence selection 
Sequence: | 23 41 17.seq z Search sequences 


(| Force .seq recomputation 


Image selection in sequence 
</media/laurent/LaCie/lrg/23_41_17.seq>: 634 images selected out of 634, no reference image set 


| © — +| O excluded (| reference image 


exclude all | include all 


Sequence export 








Base name: | || MP4 + Export sequence 
(C) Normalize images Fps: | 1.006 | O Resize | 1304 |x| 976 = | Select area to crop 
Console 


| Type help for the list of supported commands 





Ready. 
Current working directory:/media/laurent/LaCie/lrg @Stop | | Change dir... 
Current working sequence:/media/laurent/LaCie/lrg/23 41_17, 634 images selected Mem: 102MB |4 — + | 
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1.11.1. Point Spread Function 


Red channel | Green channel Blue channel 


Dynamic PSF 


x: 0403 y: 0200 20 |1 0.055318 0.043643 
= _ Star Detection | 
Radius: T 
Threshold: 1.00 


G 


Ti <* ‘oe 


= Roundness threshold: | 0.6 


Current working pe. 


Current working sequ 





FWHMx FWHMy r RMSE 


Angle 








Dynamic PSF 


yo FWHMx 


FWHMy r Angle RMSE 


1 0.067756 0.772849 
1 0.065036 0.464481 


256.67 
670.63 4.60px 


2.096e-02 
1.928e-02 








1 0.464199 0.593336 
1 0.057988 0.212339 


509.23 4.37px - 
1166.14 512.02 


4.32px 





0.056489 0.157844 


1 


6.867e-03 
6.767e-03 


1 0.058252 0.131634 
1 0.057162 0.102112 


4.88px 


4.30px l [ 


5.333e-03 
6.498e-03 


0.056720 0.110414 


1 


4.36px 


1 0.056676 
1 


4.14px 


0.055162 0.053039 


1 
1 


0.056079 0.049117 985.24 





= 


0.055318 
ar Detection 


4.542e-03 


hreshold: 1.00 


oP a oP oP oP oP oP oP oP oP le ol el lo oe ol oy 


oundness threshold: | 0.6 








Radius: 
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Size in pixels of the search box. 


@ Threshold value 


Threshold: 1.00 Tr 





Threshold value above the noise for stars detection. 


The median and standard deviation values of the image are determined, then the threshold is: 
median + [threshold] x stdev. 


© 
| The default value for threshold is 1.00. 


© Threshold value 


Roundness threshold: | 0.6 - + 





Threshold value of star roundnesses. Decrease this value if your stars show small trails. 


Ensure you have a good reason to change this value because it may degrade the star detection. 


© Star Detection 
© 


Detect stars in the current loaded image (not sequence image) and compute PSF 


© PSF parameters 
D 


Average PSF parameters for selected stars 
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Average Star Data 


Average Gaussian PSF 


N: 24 stars 
B: 0.073992 
A: 0.200688 


FWHMx: 4.34px 
FWHMy: 3.83px 

r: 0.883 
Angle: 0.00 deg 
rmse: 9./32e-03 


OK 


© Export PSF 
p 


Export PSF parameters in a ASCII file 


* 


| Save as stars. 1st in the current working directory 


@ Remove 


Remove a star from list 


© Remove all 


Remove all stars from list 


The PSF function uses the Levenberg-Marquardt/"##Ps//en.wikipedia.org/wiki/LevenbergEZ%80% 


93Marquarat_algorthm] for minimization 
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P Dynamic PSF 


Siril functions 


Dynamic PSF is a dynamic tool inspired by the Pixinsight routine of the same name. It is used to fit 
unsaturated stars within the image. 


For now, the PSF model is restricted to a 2D Gaussian function which is sufficient in most cases. 


S View full-screen video 


Right click and choose "view video" 


E New a graph interfa... x 
< = 


Documentation 





emendar eee tint in 
processed images 
RGB Compositing 
Planetary 
Both 
Some processing re: 
made with Siril 
Photometry 
Thanks 


Tools 








> ky > New a graph int 
C2 New a graph interface to display quality registra 


Dynamic PSF 


@ Blog Enews v @Getting Started @ Débuter avec Firefox B Most Visitedy @ Getting Started Astronomie” B Most Visited € Getting Started 
Glossary Procedure index 





tion information 





In your browser, click go back one page to exit 
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€ free-astro.org LÒ + RhA QC HE = 


| BB Les plus visités v Linux Mint Community © Forums @Blog Newsy @ Getting Started @ Débuter avec Firefox Æ Most Visitedy @ Getting Started Astronomie Most Visitedy @ Getting Started 





a 
| = - o siril v0.9.3 home/cyril/images/Vincent/IMG 


B&W layer 





The stars are closely surrounded by orange circles 


2D Gaussian 


| (exo), (y-Yo) | 


2 2 
20 20, 


G(x, y)=BtAe s 
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Parameters: 
@ B: The average local background in the [0, 1] range. 


@ A: The maximal intensity of the star in the [0, 1] range: this is the peak value of the fitted 
function, located at the centroid coordinates x0 and yO. 


@® x0andy0: The centroid coordinates in pixel units, which is the position of the center of 
symmetry of the fitted PSF. 


© FWHM, and FWHMy, : The Full Width Half Maximum on the X and Y axis in pixel units. 


These parameters are calculated as follow : 
© FWHM, = 20xV2log2 


© FWHM, = 20y\2log2 


@ ltis possible to obtain the FWHM parameters in arcseconds units. This requires you fill all fields 
corresponding to your camera and lens/telescope focal in the setting parameter window. If 
standard FITS keywords FOCALLEN, XPIXSZ, YPIXSZ, XBINNING and YBINNING are read 
in the FITS HDU, the PSF will also compute the image scale in arcseconds per pixel. 


© r: The roundness parameter. It is expressed as FWAM, /FWHMy , with FWHMy>FWHM\,, the 


symmetry condition. 


@ Angle: The rotation angle of the X axis with respect to the centroid coordinates in the [-90, 90] 
range. The angle @ 


is computed as follow: 
© x’=+xcos6+ysing 
© y'=-xsin0+ycose 


@ RMSE: This is an estimation of fitting quality. The smaller the RMSE is, the better the function is 
fitted. 


®© Minimization 


Minimization is performed with a non-linear Levenberg-Marquardt algorithmltps//en.wikipedia.org/wiki 
/Levenberg-Marquarat_algorithm] thanks to the very robust GNU Scientific Librar oe eee acess 
/programming/gsl-1.0/gsl-ref_35.html] 


As a first step, the algorithm runs a set of parameters excluding rotation angle in order to set good 
Start values and thus, avoiding possible divergence. If ox-0y>0.01 (parameters directly computed 
in the 2-D Gaussian formula, see above), then another fit is run with the angle parameter. 


Therefore, the Siril Dynamic PSF provides accurate values for all the fitted parameters. 


* Use 


| Dynamic PSF can be called from two different ways depending on what you want: 


You may want to fit just one star 


In this case, after drawing a selection around an unsaturated star (this is important for the accuracy of 
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@ You can select and/or remove a star choosing it in a tree list. 


0.112190 


A 
0.663412 


0.608713 


xO 
1339.68 


902.08 


Dynamic PSF 


FWHMx FWHMy 


You can export the result of the PSF in ASCII file. 


In the case you want to deal with many stars and average it 





RMSE 
3./69e-03 


3.312-03 


© The dynamic PSF window is shown and provides very valuable tools: 


© 
èe You can run the star detection algorithm by clicking on the corresponding button. 
O 


You can average the PSF results and copy and paste the result. 
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the result) you can either type "PSF" in the prompt of the console or do a right click and choose the 
"PSF" item. 


In both case you will be able to copy the result and paste it where you want. In this cased a relative 
magnitude is computed following —2.5xlogl where | is the total intensity of the fitted star. 


You must work on the dynamic PSF window by ever clicking on the "Analysis" menu and the "Dynamic 
PSF" item or drawing a selection around an unsaturated star, doing a right click and selecting the "Pick a 
star" item. 
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x Average Star Data 


Average Gaussian PSF 


N 8 stars 

B 6.114466 
A: 6.352561 
FWHMx: 7.3/7 px 
FWHMy: 6.68px 

r: 0.907 
Angle: 63.21 deg 
mse: 3.433e -03 


OK 


Star detection 

As said before, this dynamic PSF also contains an automatic tool of star detection. 

e This algorithm is based on the publication of Mighell, J.J P71. which is a simple peak detector 
algorithm identifying any pixel that is greater than any of its eight neighbours. 


@ In addition to this basic algorithm, a PSF is applied on every possible "detected stars" and Siril 
rejects all detected structures that don't fulfil a set of prescribed detection criteria. 


@ Finally, a circle is drawn around detected stars. Nevertheless, if a non-stellar object is selected, it is 
possible to select it and remove it from the list. 


You may notice that during the automatic star detection, no rotation angle are fitted due to speed 
consideration. 


1.11.2. Statistics 


Statistics access 


By the menu= Analysis/Statistics... 
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| File Edit Image Processing Analysis Windows 


Dynamic PSF... 


File conversion Sequence Pre-proc lot Stacking Output logs 


Statistics... 
This conversion tab is used to AN EPS Te mn into a format with which Siril can work: FITS or SER. 
Source 
Name Date dh 
= 
x] 
Destination 
—— — — — Colour image target 
Bei core las ; © Keep three channels 
ov | i _ Create three images 
sConvert Demosaicing 


Keep only first channel 


BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, 


Supported file types: SER sequences, TIFF images, JPG images, PNG images. 


Console 





Type help for the list of supported commands 


Ready. 


Current working directory: /media/laurent/Data/save juillet 2016/astro @Stop | | Change dir... 





Current working sequence:-none - Mem: 93MB 4 = 


By right click in picture 





siril v0.9.4 - /home/laurent/Documents/traitement 


Red channel Green channel Blue channel 


Statistics 











| Red x: 1813 y: 1166 = 131 andromède07-16.jpg (channel 0) fwhm: no selection 
`) cut 255 | Q Min/Max 
MIPS-LO/HI 
= oe 0 User 


wy) Ge =- A ha ae Eu Asinh v Zoom to fit v 
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Statistics 


Normalized Real [0, 


1] 


fhome/laurent/Documents/andromède07-16.jpg 
Size of selection in pixel: (260,222) 


Red 
count (px) 57720 
mean 58.4 
median 43.0 
sigma 41.5 
avgDev 25.9 
MAD 13.0 
sqrt(BWMV) 22.3 

| min 0.0 

max 247.0 


© statistics of an image area 








06/08/18 


If you want to know the statistics of an image area, select it, then click Execute 


siril v0.9.4 - /home/laurent/Documents/traitement 





Red channel 





| Red x: 0107 y: 0521 = 001 


_) cut J 255 

G= 0 
DC» AN ke OB asin ă 
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Green Blue 
S7720 57720 
55.6 58.4 
39.0 43.0 
43.1 43.7 
2 7.0 28.0 
13.0 15.0 
22.1 25.5 
0.0 0.0 
247.0 247.0 

érExecute close 





Green channel Blue channel 


_| Normalized Real [0, 1] 
fhome/laurent/Documents/andromède07-16.jpq 
Size of selection in pixel: (284,259) 


count 
mean 


Red 
(px) 73556 
51.9 


median 39.0 


sigma 


39.6 


avgDev 23.9 


MAD 


12.0 


sqrt(BWMV) 20.3 


min 
max 





0.0 
247.0 


androméde07-16.jpg (channel 0) 


zal 


Green 
73556 


48.8 
35.0 
41.2 
24.9 
13.0 
21.2 
0.0 


247.0 


Blue 


13556 
51.4 
38.0 
42.0 
26.1 
14.0 
23.3 
0.0 
250.0 





Execute 











Fwhm = 91.67, r = 0.85 


| © Min/Max 
` MIPS-LO/HI 
© User 


Zoom to Fit + 
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© Selected area 





est 00018.fit (channel 0) Fwhm = 6.22, r = 0.96 
KEEIE © Min/Max 
_ when an area is selected, FWHM and roundness in pixels are displayed 


Q 


ris the ratio of the FWHM in x and y. 
If the value is 1, it means that we have a perfectly round star. 


1.11.3. Noise Estimation 


Display noise estimation in | Output Tab 


11:44:39: Noise standard deviation: calculating... 

11:44:39: Background noise value (channel: #0): 0.548 (2.150e-03) 
11:44:39: Background noise value (channel: #1): 0.777 (3.048e-03) 
11:44:39: Background noise value (channel: #2): 0.518 (2.033e-03) 
11:44:39: Execution time: 100.71 ms. 





1.12. Settings 


1.12.1. DSLR RAW debayer 


DSLR RAW debayer | Other debayer Camera&Optics Misc. 


Image Color Adjustement Image Gamma Correction 
Use automatic daylight multiplier © Linear 
Red 1 BT.709 curve 
SRGB curve 
; SES pa we Image White Balance 
Brightness TOO dt dé g 


No black point correction Use the white balance 
specified by the camera 
Image Matrix Interpolation Calculate the white balance 
by averaging the entire image 
Patterned Pixel Grouping (PPG) v 


Close 
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1.12.1.1. Image Color Ajustement 


WUse automatic daylight multiplier 
When this option is enabled, coefficients for each channel are automatically computed. You can choose 


your own multiplier by unchecking this box. 


Image Color Adjustement 








[| Use automatic daylight multiplier 



































9 + 
, Brightness 1.00 | —| + | 


[| No black point correction 


o 
Red HA 


Red 
Specify your own raw white balance. The value for the Red scale is relative to the Green. 


2, 
Blue [1.00 or 


Blue 
Specify your own raw white balance. The value for the Blue scale is relative to the Green. 


© 
ee fs [=|] 


Brightness 
Divide the white level by this number. 


No black point correction 
When this option is enabled, no black point correction is applied to raw images. 
1.12.1.2. Image Matrix Interpolation 


Select an interpolation method to perform demosaicing before opening image. 
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P High-speed, low-quality bilinear interpolation method 


Bilinear interpolation is quite fast , color error is reduced and resolution is in-creased. Given the 
improvements and the modest computational cost, many devices like webcams will employ bilinear 
interpolation to reconstruct the image. 


®© Variable number of Gradients 


= VNG 
This CFA recovery algorithm uses a threshold-based variable number of gradients. In order to 
recover missing color information at each pixel, we measure the gradient in eight directions based 
on a 5 X 5 neighborhood surrounding that pixel. Each gradient value is defined as a linear 
combination of the absolute differences of the like-colored pixels in this neighborhood. We then 
consider the entire set of eight gradients to determine a threshold of acceptable gradients. For all of 
the gradients that pass the threshold test, we use color components from the corresponding areas 
of the 5 X 5 neighborhoods to determine the missing color values. 


| Color filter array recovery using a threshold-based variable number of gradients{P*001 


P Adaptive Homogeneity-Directed 


= AHD 
The direction to interpolate is chosen to minimize the level of color artifacts. 


Due to the rectangular sampling lattice in Bayer pattern, interpolation is performed in horizontal and 
vertical directions only . 


Directional interpolation uses filterbank techniques to cancel aliasing from CFA sampling. 


| Adaptive Homogeneity-directed DemosaicinglP?00 


# Patterned Pixel Grouping 


= PPG 
Patterned Pixel Grouping interpolation is an advanced interpolation method which is designed to 
maintain the high image quality and minimize the interpolation artifacts from the output. 


[p.200] 


Pixel Grouping 


1.12.1.3. Image Gamma Correction 


112 


OLinear 


No gamma correction is applied to the image. 
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©BT.709 curve 


Apply a specific gamma curve to the image. 


# BT.709 


= Rec. 709 
Standardizes the format of high-definition television, having 16:9 (widescreen) aspect ratio. The first 
edition of the standard was approved in 1990. 


Recommendation ITU BT 709/ttp//www.itu.intrec/R-REC-BT.709/en] 


©sRGB curve 


Apply a specific gamma curve to the image. 


sRGB [https://www.w3.org/Graphics/Color/sRGB.html] 


1.12.1.4. Image White Balance 


(Use the white balance specified by the camera 
By default, libraw uses a fixed white balance based on a color chart illuminated with a standard D65 


lamp. [Mtes//en.wikipedia.org/wiki/lluminant_D6SI it you check this box, libraw will try to use data specified by 
your camera. 


(Calculate the white balance by averaging the entire image 


By default, libraw uses a fixed white balance based on a color chart illuminated with a standard D65 
lamp. If you check this box, libraw will compute the white balance by averaging the entire image. 


1.12.2. Other debayer 


Settings 


DSLRRAW debayer Otherdebayer Camera&Optics Misc. 
Debayer 
Bayer pattern from file's header if available 


Bayer/mosaic pattern: | RGGB v 








Debayer interpolation: | VNG z 


Close 
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1.12.3. Camera & Optics 


1.12.4. Misc. 


1.13. Contextual help 


Q 


Settings 


DSLR RAW debayer Other debayer Camera & Optics Misc. 
Camera and Optics 

Focal length (mm): || | 

Pixel X dim. (micron): | | 


Pixel Y dim. (micron): | 


Binning: 

















WARNING: these fields are automatically read from FITS file on opening and setting them here will only 


work for the currently loaded file. 


Close 





Settings 


DSLR RAW debayer Other debayer Camera & Optics Misc. 


Swap Storage Directory 





5 tmp 


Directory: 


Restore to Default 





Memory Managment 


Ratio of Available Memory Used: | 0.9 
FITS Format 


Type of extension: fit + 


Confirmation dialog 
( ) Don't ask before quitting 








Look and feel 


m Using dark GTK theme 
(may require restarting) 


Close 





User guide 


On mouseover, context sensitive help is available for most input box, radio button, checkbox button 


text. 


Allow a few seconds motionless mouse to access a tooltip. 


1.14. Keyboard shortcuts 


# Ctri+O 
| Open file 


© Ctrl+s 


| Saving the image (FIT format) 
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© Ctrl+T 
| Saving the image (TIFF format) 


© Ctrl+B 
| Saving the BMP image 


© Ctrl+J 
| Saving the JPG image 


© Ctrl+P 
| Saving the NetPBM image 


© Ctrl+Z 
| Undo 


© Shift+Ctrl+Z 
| Redo 
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2. Tutorials 


2.1. Deep Sky 


2.1.1. Convert your images in the FITS format Siril uses (image import) 
© 


To process your images with Siril, you must convert them to the FIT 


S [https.//fr.wikipedia.org/wiki 
/Flexible_Image_ Transport System] format it uses (16-bit unsigned, bottom-top order, 1 or 3 axes). 


Fortunately, Siril is able to convert some image formats to this format, RAW, TIFF, JPEG, PIC!?20°) 
PNG, BMP and NetPBM binaries for images, AVI and other films. 


Siril control center 
1) Edit Image Processing Analysis Windows Help 
eee 7 


| File conversion 
Je 


I Image sequences 
I 


x 





Pre-processing 





Registration Stacking Output logs 
This conversion tab is used to import files and convert them into a format with which Siril can work: FITS or SER. 
| Name 





Source 





Date | 


+ 








4 

















Destination 
r à Colour image target 
pn iniEs | | +) Keep three channels 
_ () Create three images 
3 Convert |_| Demosaicing 
() Keep only first channel 
Supported file types: BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, SER 1 
I sequences, TIFF images, JPG images, PNG images. 1 
Console 
| Type help for the list of supported commands 
Rea 





Current working directory: /home/laurent 











Current working sequence: andro_, 79 images selected 








| @ Stop | | Change dir | 
Mem: 291MB | 4 — 








| File conversion 


conversion tab 





Supported file types: 


BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, SER 
sequences, TIFF images, JPG images, PNG images. 


Supported Formats 
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A 


| when pretreated images do not directly demosaicing RAW files ! 


2.1.1.1. Images formats natively supported 


@ FITS images in 16-bit unsigned ( fits other formats are converted on the fly) 
© SER files 


@ AVI and many other films. 


A 


The AVI support as has been abandoned in favor of SER format. Consequently, several functions 
may not work with AVI movies. However, this version of Siril can convert AVI movies in SER format 
which will then be perfectly usable. 








2.1.1.2. add the files to be converted 


Click on the +] button to add the files to be converted. 

















Siril control center - 4+4 X 
File Edit Image Processing Analysis Windows Help 
































File conversion || Image sequences | Pre-processing | Registration | | Stacking | | Output logs | 
This conversion tab is used to import files and convert them into a format with which Siril can work: FITS or SER. 
Source 
Name Date p 
i 
-i 
i 
I 
bora 
Destination 
| | | Colour image target 
S > 1 
gee © Keep three channels 
(Ù Create three images 
Čz Convert [C] Demosaicing ` i 
() Keep only first channel 





BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, SER 


ee sequences, TIFF images, JPG images, PNG images. 







Console 

















| Type help for the list of supported commands 

| Ready. 
Current working directory: /home/laurent/Bureau/test traitement | © Stop | | Change dir 
Current working sequence: - none - Mem: 52MB | 4 || ee 





and 


Add the files to convert 
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Remove files 


A 


118 


a 


Remove all files 


User guide 


All supported formats can be selected at same time and will be converted in a sequence of files 
starting with the generic name you've specified just below. Created file names will be in the form 
Name_XXX, where XXX is the number of each image in the sequence. 


The button WDemosaicing must be unchecked in order to convert RAW files into CFA (Color Filter 
Arraylttes./en.wikipedia.org/wik/Color_tilter_arrayl) monochrome FITS pictures, a necessary step to pre- 


process DSLR images. 


r 


x sie Siril control center 
| File Edit Image Processing Analysis Windows Help 
File conversion Image sequences Pre-processing Registration 


Stacking Output logs 





Source 


Name 


fhome/cyril/images/Bulle/LIGHT_300s_800iso_+19c_20150822-00h10m56s989ms.CR2 


fhome/cyril/images/Bulle/LIGHT_300s 800iso +20c_20150822-00h21m365403ms.CR2 


fhomeycyrilimages/Bulle/LIGHT_300s 800iso +20c_20150822-00h31m31s194ms.CR2 
fhome/cyri/images/Bulle/LIGHT_ 3005 800iso +20c_20150822-00h41m38s5809ms.CR2 
fhome/cyrilimages/Bulle/LIGHT_300s_800iso_+20c_20150822-00h51m52s581ms.CR2 
| | fhome/cyril/images/Bulle/LIGHT_300s_ 800iso_+20c_20150822-01h01m52s722ms.CR2 
fhome/cyril/images/Bulle/LIGHT_300s 800iso_+20c_20150822-01h11m56s919ms.CR2 
Uthomelcuriliimaneac@ullal GMT 20Nc ANNica sAr 20150222.01h21m30cA2Ome CRP 


j Destination 


| 93 Convert 


| Supported file types: TIFF images, JPG images, PNG images 
Console 


ype help for the list of supported commands 


Current working directory: fhome/cyril/images/Bulle 


Current working sequence: NGC7635_, 13 images selected 
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| This conversion tab is used to import files and convert them into a format with which Siril can work: FITS or SER 





Date 

Sat Aug 22 02:16:06 2015 jf) * 
Sat Aug 22 02:26:44 2015 

Sat Aug 22 02:36:40 2015 

Sat Aug 22 02:46:48 2015 BI ” 


Sat Aug 22 02:57:02 2015 M 
Sat Aug 22 03:07:02 2015 
Sat Aug 22 03:17:06 2015 J 


Sat Aun 22 92-26-42 NISL 
13 files loaded 








m zil Colour image target 
Sequence name: | NGC7635 | 1 e) Keep three channels 


Create three images 


| Dem 3 
oa ee _) Keep only first channel 


BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, SER sequences, 





@ Stop Change dir... 


Mem: 133MB 8 - 
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x a o Siril control center 


| File Edit Image Processing Analysis Windows Help 








File conversion Image sequences Pre-processing Registration Stacking Output logs 








: Decoding Canon E0S 11000 file (150-806, Exposure=300s) 

: Reading RAW: file LIGHT 300s 800iso +20c 20150822-08h41m38s889ms.CR2, 1 Layer(s), 4290x2856 pixels 
: Saving FITS: file NGC7635 90004.fit, 1 layer(s), 4290x2856 pixels 

: Decoding Canon E0S 11000 file (150-806, Exposure=300s ) 

: Reading RAW: file LIGHT 3005 808iso +20c 26156822-06h51m52s58lms.CR2, 1 layer(s), 4290x2856 pixels 


: Saving FITS: file NGC7635 60005.fit, 1 layer(s), 4290x2856 pixels 

: Decoding Canon EOS 1100D file (150-898, Exposure=300s) 

: Reading RAW: file LIGHT 300s 860150 +20c 260150822-01h61m525722ms.CR2, 1 layer(s), 4290x2856 pixels 
: Saving FITS: file NGC7635 68006.fit, 1 layer(s), 4290x2856 pixels 

: Decoding Canon E0S 1100D file (150-800, Exposure=300s) 

: Reading RAW: file LIGHT 306s 800iso +20c 260150822-61h11m56s919ms.CR2, 1 Layer(s), 4296x2856 pixels 
: Saving FITS: file NGC7635 90007.fit, 1 layer(s), 4290x2856 pixels 

: Decoding Canon E0S 11000 file (150-800, Exposure=300s) 

: Reading RAW: file LIGHT 300s 808iso +20c 26150822-61h21m39s430ms.CR2, 1 layer(s), 4298x2856 pixels 
: Saving FITS: file NGC7635 90008.fit, 1 layer(s), 4290x2856 pixels 

: Decoding Canon E0S 1100D file (150-806, Exposure=300s) 

: Reading RAW: file LIGHT 300s 806150 +20c_26150822-61h31m23s618ms.CR2, 1 layer(s), 4290x2856 pixels 
: Saving FITS: file NGC7635 60609.fit, 1 layer(s), 4290x2856 pixels 

: Decoding Canon E0S 11000 file (IS0=806, Exposure=300s) 

: Reading RAW: file LIGHT 30@s 808iso +20c 20150822-01h41m43s318ms.CR2, 1 layer(s), 4298x2856 pixels 
: Saving FITS: file NGC7635 090010.fit, 1 layer(s), 4290x2856 pixels 

: Decoding Canon E0S 11000 file (150-806, Exposure=300s ) 

: Reading RAW: file LIGHT 300s 808iso +20c 26150822-01h52m12s249ms.CR2, 1 layer(s), 4296x2856 pixels 
: Saving FITS: file NGC7635 60611.fit, 1 layer(s), 4296x2856 pixels 


de de de En de Le de Le ne de Ee de Le de Le de Ed Le & LE & he & 


RSS SR SSSR SES. 
BRERSRSOCCUOCOSERSERREEEELSS 











Console 
Type fh £ rt! j 
| Current working directory: fnome/cyrilimages/Bulle @ Stop Change dir... 
Current working sequence: NGC7635_, 13 images selected Mem: 133MB 8 - 








Indeed, due to Bayer matrix consideration, the RGB result of your RAW image is an interpolated 
picture. In consequence pre-processing interpolated data will give wrong results. Contrary to RGB 
image, CFA image represent the entire sensor data with the Bayer pattern. The following image 
shows you a crop of a CFA image. Note that the Bayer pattern (RGGB on this example) is visible. 


Here 
FREE: 


SS, S88 eee Beas 8 
a 
Li 
a 


See Be Sn! 
8-8-8 8 8-2 8-8 8:8 EE 
SB@eceegeaneseeaa a a 
Se 8a ena se 2 eS eS es & 
ESS cages @ ea ah 





2.1.2. Pre-processing images 


Once a sequence is loaded, images can be pre-processed, registered and stacked. The pre-processing 
is an optional, yet important, step and involves bias, dark and flat frames. Pre-processing a sequence in 
Siril can only be done with master bias, dark and flat frame, which have to be created from their 
sequences first. The way these master frames can be created is described in the sections below, see 


also the <> stacking documentation PS8, 


P Pre-processing 
The preprocessing operation consists in computing the following equation: 


light — masterDark — masterBias 


calibrated image ET — masterFlatDark - master Bias 
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For pre-processing, Siril applies master offset/bias, dark and flat images to the current sequence. 
These master images thus have to be processed before processing the actual image sequence. Siril 
currently does not support processing multiple sequences at the same time, so each layer of the final 
image must be processed independently before assembling them into an RGB image. 


2.1.2.1. Prepare dark, flat and bias 


2.1.2.1.a. Bias 


# ABIAS frame 


= offset 


is an image taken with the shutter closed and the shortest possible exposure time. Basically it 
corresponds to an exposure of 1/4000s with modern DSLRs. The BIAS shows the electronic noise 
and readout signal of the camera and the more BIAS exposures are used for the calculation of the 
master BIAS, the less noise will be introduced into the corrected images. Note that BIAS frames 
MUST be taken at the same ISO than light frames. 


The master bias frame should be created by stacking bias frames with the median algorithm (or 
Winsorized by checking the rejection levels at the end of the process, they should be lower than 0.5 
percent), but be sure to use No Normalization. 


© 


Here, a master BIAS, calculated from 10 single images with Winsorized sigma clipping. 
12:58:34: Pixel rejection in channel #0: 0.368% - 0.354% 
12:58:31: Integration of 10 images: 


S a ma a e eet Gann eaa ee None 
PSS A TEI INS ie en a a WEL ise hee) | oigna Ol IppPINg 
12:58:34: Rejection parameters ...... low=3.200 high=3.300 
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2 
| x = o siril v0.9.5-alpha - /home/cyril/Images/Bulle 


B&W channel 





à b- > A h E F & AutoStretch + Zoom to fit + 


2.1.2.1.b. Dark 


© Darks 
Dark frames are made at the same exposure time and ISO as the subject light frames but in the 
dark: use your lens/telescope cap or close the shutter for example. 


They contain the thermal noise associated with the sensor, the noise being proportional to 
temperature and exposure time. Hence, they should be made at approximately the same 
temperature as the light frames, this is the reason why we make dark frames at the end, or in the 
middle of the imaging session. 


Like with the BIAS frames, the more dark exposures are used for the calculation of the master dark, 
the less noise will be introduced into the corrected images. 


The master dark frame should be created by stacking dark frames with the median algorithm (or 
Winsorized by checking the rejection levels at the end of the process, they should be lower than 0.5 
percent), but be sure to use No £? £ Normalisation 


Remember that dark frames are always composed from real dark signal and bias signal. 


If you don't apply dark optimization, you can leave the bias signal and your masterDark will be in fact 
masterDark+masterBias. 


In consequence subtracting this master to the light frames will remove both signals. 


However, applying dark optimization makes things different by multiplying masterDark by a 
coefficient factor not equal to 1. 


In this case, you must subtract masterBias from each dark frame. 
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© Here, a master dark, calculated from 10 single images with Winsorized sigma clipping. 


13:00:40: Pixel rejection in channel #0: 0.340% - 0.384% 
13:00:40: Integration of 10 images: 


Re DO AO Sorma z LPO ee ees None 

ee OO AO ase xe r TON re Winsorized sigma clipping 

13:00:40: Rejection parameters ...... low=3.200 high=3.300 
= siril vO.9.5-alpha - /home/cyriliimages/Bulle SSS 


B&W channel 





D, ir > A ™ F E AutoStretch ~ Zoom to fit ~ 


2.1.2.1.c. Flat 


®© Flat 


Telescopes usually do not illuminate the detector homogeneously. Moreover, dust on optical 
surfaces and sensor lead to darker patterns on resulting image, and the sensor itself has a different 
response to the number of photons hitting different photosites. To correct these effects one need to 
divide each light images by the master flat, which should be the median of single exposures of a 
homogeneously and non-saturating illuminated area. 


Remember that flat frames are always composed from real flat signal and bias signal. So you must 
subtract master-bias from each flat frames to obtain real master-flat. In addition, if flat frame 


exposures are too long, a r?dark-flat signal should also be removed. 


Siril automatically evaluates the normalisation coefficient used in the flat division. However, this value 
can be self-evaluated. 
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The master flat frame should be created by stacking flat frames with the median algorithm (or 
Winsorized by checking the rejection levels at the end of the process, which should be lower than 
0.500), and choose Multiplicative normalisation. 


© Here, a master flat, calculated from 9 single images with Winsorized sigma clipping 


method. Note that vignetting and dust are visible. Bayer pattern is also visible. 


To: 
leone 
Pos 


LS 


GS 


O5 


DS 
05 


LS s0 5% 


Aor: 
A 
Zoe 
PO 
LISE 


Pixel rejection in channel #0: 0.388% - 0.304% 


Integration of 9 images: 





None dar si eo) que mares ane are eee multiplicative 
Pa xeulen en SC S a <i case sees teks Winsorized sigma Clipping 
Rejection parameters ...... low=3.400 high=3.700 

= . o smi vO.9.5-alpha - /home/cyril/images/Bulle 








x: 3823 y: 1635 = 1629 master-flat.fit (channel 0) 
- e) Min/Max 


( ) MIPS-LO/HI 














| ) User 


OCP Al lh BF M Hom ~| | Zoom tot = 





2.1.2.2. For DSLR images 


Pre-processing DSLR images without dark optimization 


When dark optimization is not used and masterFlatDark not needed, one good method is to process 
like that: 


GD Integrate all bias to build master-bias 
2) Integrate all darks to build master-dark 
© Calibrate flat frames with master-bias 
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4, Integrate all calibrated flat to build master-flat 


©) Preprocess light frame with master-dark and master-flat 


== Whole DSLR images processing batch 


If you want to do the whole processing batch, once again with no masterFlatDark but with dark 
optimization, you must remove the master-bias from the master-dark before: 


GD Integrate all bias to build master-bias 

O Calibrate dark frames with master-bias 

a Integrate all calibrated darks to build master-dark 
(a) Calibrate flat frames with master-bias 

© Integrate all calibrated flat to build master-flat 


© Preprocess light frame with master-bias, master-dark and master-flat 


2.3. Pre-processing and FIT images 


The pre-processing does not overwrites original FITS files from the sequence but creates new FITS 
files with the pre-processed data. 


The new file names are the same than the original prefixed with pp_ if you leave the default value in 
the prefix box. 


Below is an example of pre-processing using offset and dark files. 
Make sure that loaded sequence is the sequence of your light frames. 
Also, note that at the end of the process, the new sequence is automatically loaded. 


o Siril control center 
File Edit Image Processing Analysis Windows Help | 
File conversion Image sequences Pre-processing Registration Stacking Output logs 
| Pre-processing is an optional step to apply to a sequence of images 


| Dark, offset (bias) and flat files can only be a single FITS file. 
| 


Use offset master-bias. fit Browse.. 





v Use dark Momeycyrilimages/Bulle/master-dark.fit Browse... 
Dark optimization 
+ Use flat /home/cyrilAmages/Bulle/master-flat.fit Browse... 
v Auto evaluate normalisation value 
Cosmetic correction (using master-dark) 
W Enable Cosmectic Correction 
# Cold Sigma: | 3.000 - + + Hot Sigma: | 3.000 — + v CFA 


Output sequence 


| Store resulting sequence with prefix: | pp_ 





Start pre-processing 





Console 
| Current working directory: /home/cyril/images/Bulle @ Stop Change dir... 
Current working sequence: NGC7635_, 13 images selected Mem: 644MB 8 - 
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Since 0.9.2 version, a new tool is available in the preprocessing tab: cosmetic correction. This tool 
search deviant pixels through master-dark and will correct them. You always should use this tool if 
you own master-dark. Please, pay attention to the CFA box. Check it if your monochrome pictures are 
CFA images. If you don't have master-dark (which should be avoided), you could use automatic 


cosmetic correction tool available through the =image processing menu. 


© Results examples 


The result of a single frame pre-processed is given below. Note how dust have been removed from 
the light frame. 
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2.1.2.3.a. Simplified workflow since 0.9.9 


Siril control center 
Edit Image Processing Scripts Analysis Windows Help 
File conversion Sequence Pre-processing Registration Plot Stacking Output logs 


Pre-processing is an optional step to apply to a sequence of images. 
Dark, offset (bias) and Flat Files can only be a single FITS file. 
| Use offset | master-offset.fit 


iw) Use dark master-dark. fit 


| Dark optimization 
i) Use flat master-flat. fit 


Browse... 


ra Auto evaluate normalisation value 
Cosmetic correction (using master-dark) 
[e| Enable Cosmectic Correction 


| Cold Sigma: | 3.000 + | Hot Sigma: | 3.000 — | + ww) CFA 
Estimate Cold: 0 px Hot: 0 px 


Output sequence 


i) Demosaic FITS i mgors before saving 


Store resulting sequence with prefix: | pp_ 


Check this option iF you want to apply 


a demosaicing algorithm to your FITS 
images right after they were preprocessed. B 


sed. By doing this, you skip one manual 
step which can take some time. 


WARNING: this option is only available for FITS images as SER sequence can be 
demosalced on-the-fly. 


Current working directory: fhome/laurent/Bureau/video (@ Stop Change dir... 
Current working sequence: - none - 





Meme: 73MB 4 
Disk Space: 227G 


Q 


You can check Wdemosaic FTIS images option before saving . 
This allows you to skip the manual conversion step 


Valid only for FITS, Ser files are demosaiced on the fly. 


2.1.3. Special case of demosaicing 


Demosaicing (for Bayer-Pattern images only) 


Last step in pre-processing images consist in getting back Red, Green and Blue channels using 


interpolation algorithms. To do that, Siril gives the choice between 5 different algorithms. 
@ VNG (default) 


© Bilinear (low quality but fast) 
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Nearest neighboor 


AHD 
Super Pixel (no interpolation, the pattern RGGB, or other, is used as a super pixel and the image size 


is divided by four). 
Make your choice in the window below by clicking on Settings and |Other debayer tab. 


| E Settings 


| DSLR RAW debayer Other debayer Camera & Optics Misc. | 





SER sequences 
+| Bayer pattern from file's header 


Debayer 
|| Bayerimesaic pattem: | AGGE 


Debayer interpolation: | WNG ll 
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æ To process the demosaicing 


GD Go back to Conversion Tab) and fill the field as the example below: 





x =. 0B Siril control center 
File Edit Image Processing Analysis Windows Help 
File conversion Image sequences Pre-processing Registration Stacking Output logs 


This conversion tab is used to import files and convert them into a format with which Siril can work: FITS or SER. 














Source 

Name Date 
[home/cyrilimages/Bulle/pp_NGC7635_00012.fit Mon Sep 5 13:00:31 2016 9 
[home/cyril/Images/Bulle/pp_NGC7635_00011.fit Mon Sep 5 13:00:31 2016 
/home/cyril/images/Bulle/pp_NGC7635_00010.fit Mon Sep 5 13:00:31 2016 |B) ~ 
/home/cyril/images/Bulle/pp_NGC7635_00009.fit Mon Sep 5 13:00:30 2016 
fhome/cyril/images/Bulle/pp_NGC7635_00008.fit Mon Sep 5 13:00:30 2016 
f/home/cyril/images/Bulle/pp_NGC7635_00007.fit Mon Sep 5 13:00:30 2016 g 
fthoamaicuriliimanac/Rullainn NACTAIS NNNNA ft Mon Sen..5.1.32-009-30. 2016. he) 

13 files loaded 

Destination 


Colour image target 
Sequence name: | deb_NGC7635 | | 1 e) Keep three channels 


; `} Create three images 
93 Convert | Dem >< 
| è | 4 oe _) Keep only first channel 








BMP images, PIC images (IRIS), PGM and PPM binary images, RAW images, FITS-CFA images, Films, 


Supported file types: SER sequences, TIFF images, JPG images, PNG images. 





| Type help for the list of supported commands | 


Current working directory: /home/cyril/images/Bulle @ Stop Change dir... 











Current working sequence: - none - Mem: 59MB 8 - 





© Then check the Demosaicing| button and click on the Convert) Button right after. The 
demosaicing process should start and will take some time following the method you used and the 
CPU you own. 





x = o Siril control center 
File Edit Image Processing Analysis Windows Help 
File conversion Image sequences Pre-processing Registration Stacking Output logs 





: Saving FITS: file deb NGC7635 00001.fit, 3 layer(s), 4296x2856 pixels 
Reading FITS: file pp_NGC7635 00012.fit, 1 layer(s), 4290x2856 pixels 
: Filter Pattern: RGGB 
Saving FITS: file deb NGC7635 90002.fit, 3 layer(s), 4296x2856 pixels 
Reading FITS: file pp NGC7635 90011.fit, 1 layer(s), 4290x2856 pixels 
Filter Pattern: RGGB 
Saving FITS: file deb NGC7635 90003.fit, 3 layer(s), 4296x2856 pixels 
Reading FITS: file pp NGC7635 60016.fit, 1 layer(s), 4296x2856 pixels 
: Filter Pattern: RGGB 
Saving FITS: file deb NGC7635 00004.fit, 3 layer(s), 4290x2856 pixels 
: Reading FITS: file pp NGC7635 00009.fit, 1 layer(s), 4290x2856 pixels 
Filter Pattern: RGGB 
Saving FITS: file deb NGC7635 90005.fit, 3 layer(s), 4290x2856 pixels 
Reading FITS: file pp NGC7635 90008.fit, 1 layer(s), 4290x2856 pixels 
Filter Pattern: RGGB 
Saving FITS: file deb NGC7635 00006.fit, 3 layer(s), 4296x2856 pixels 
: Reading FITS: file pp NGC7635 066067.fit, 1 layer(s), 4296x2856 pixels 
Filter Pattern: RGGB 
Saving FITS: file deb NGC7635 00007.fit, 3 layer(s), 4290x2856 pixels 
Reading FITS: file pp_NGC7635 00006.fit, 1 layer(s), 4290x2856 pixels 
Filter Pattern: RGGB 
Saving FITS: file deb NGC7635 90068.fit, 3 layer(s), 4296x2856 pixels 
Reading FITS: file pp NGC7635 90005.fit, 1 layer(s), 4296x2856 pixels 
: Filter Pattern: RGGB 


SSESSSSESSSESSSSESSSESSSES 
SSSSSSRRSELESSSSSSESSSEH 























onsole 
E | Type help for the list of supported commands 
i 00006. 
| Current working directory: /home/cyril/images/Bulle @ Stop Change dir... | 
Current working sequence: deb_NGC7635_, 13 images selected Mem: 324MB | 8 - | 








Result 
@ 


Finally you will have a new set of pre-processed light frames, automatically loaded in Siril, that you 
could register. 


Please note that at this stage you always have a lot of noise in your image. 
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Indeed, pre-processing images with Dark, Bias and Flat do not remove noise but unwanted signal. 
The following Picture shows you the result of demosaicing. 


It is displayed in Auto-stretch visualisation mode in order to enhanced the visibility of signal but 
without altering your image. 











RGB image 





2.1.4. Use of registration 


* 


After debayering (if useful), the new sequence is loaded and you can check it in the |image 


sequences | tab. 


From this tab, you can change the image being viewed in the grey and color windows, include or 
exclude them from a user-defined selection that will later be used to indicate which files should be 
stacked or not, and set the reference image. 

While browsing through the images of the sequence, a reference image may be set to a specific 
image if you think it has a better quality than the others, or if it's best centred. Note that when the 
reference image is set, it will be saved in the sequence and it will be opened first when loading the 
sequence the following time. 
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airi) wO.%.S-alphae + Jhon fe yril mae Buile 





ME | Red channel Green channel Bius chancel 


dab NOCIESS Ge. Mt 1 -1 
dee MGCTASS Ooogg ft -Ù - 
deb _NGCTONS COQ ft -1 - 
deb MGCTOIS 000a Ät -L - 
det MGCTÉ3S 60008 Mt A -= 
dob MGCTESS GME. -i - 
deb MOCTENS OOOOT AL -i - 
deb NGCTOIS OOOE.AL “1 - 
deb _MGCTENS 000a. t -L - 
deb _MGCTEIS Gh10.0t 

| dob NGCTE3S Ot -1 - 
deb MOCTESS GLS MT -i - 
deb NGCTENS OOQLS FE -i - 


D D 1 OU D ii Ai -E 


a LR IQ LE Le M le li A K A Ki © 
SESEEE ESE S Eo EE 





n o A ik À mh E Auintireich © Zoom in ËE + 





E 


An alternative to the use of buttons of the sequence tab is to use the sequence list. Click on the 
dedicated button 


Q 
We align the images on the best channels. Usually it is green. 
Others will actually follow this alignment. 


At the end it is possible to do an £P RGB alignment!?:'”*! if we have an offset. 


To make registration, just click on Go Register| button. Everything will be automatic. 
The algorithm tries to match triangle patterns in order to align images. 
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# You can check each step of registration in the console output. 


Ix . ag Siril control center 
| File Edit Image Processing Analysis Windows Help 


File conversion Image sequences Pre-processing Registration Stacking Output logs 





:45: Matching stars: done 
:45: 1325 pair matches. 


745: scale: 1.068 
45: rotation: -0.07 deg 
45: dx: +4.77 px 
:45: dy: +19.95 px 
| 2:45: FWHMx: 4.80 px 


FWHMy : 3.99 px 

Saving FITS: file r deb NGC7635 00005.fit, 3 layer(s), 4296x2856 pixels 
Reading FITS: file deb NGC7635 00006.fit, 3 layer(s), 4290x2856 pixels 
Findstar: processing... 

Found 1988 stars in image, channel #1 

Execution time: 2.96 s. 

Matching stars: done 

1326 pair matches. 

scale: 1.000 

rotation: -0.08 deg 

dx: +5.86 px 

dy: +25.31 px 

FWHM«x : 4.28 px 


NNN NN N NNN N 
PERSSEEEEEESERESEE EERE ES 


SSS SSS SSS SERRARA 


FWHMy : 3.73 px 
Saving FITS: file r deb NGC7635 90006.fit, 3 layer(s), 4290x2856 pixels 
Reading FITS: file deb NGC7635 60007.fit, 3 layer(s), 4299x2856 pixels 
Findstar: processing... | 


NN 





æ 
«|g 


| Current working directory: fhome/cyrnil/images/Bulle @ Stop Change dir... 


Current working sequence: deb_NGC7635_, 13 images selected Mem: 550MB 8 - 


A new sequence will be created and automatically loaded at the end of the process. In addition, an 
average of FWHM is computed and provided in this sequence. It is thus possible to select best 
images for stacking. 


© Information displayed in the | Output logs| tab 


dU ea ee Abd rar bre big. 

11:24:32: Found 113 stars in image, channel #0 
Wie e Ee CUC LOM elles Mer 

We Ae See Wie wrelaaiae, e cuss’: Come 

IAG 2 2: oA par matches. 

dn es CENTER O00 

1I: Ade 7 see Ol ce LOM. 002 deg 

ARS SR RC RER ES mL 

TIE A 2 SON SUN 

a AA Se CM AU eee Sho 0 

ie 24237 NENENS ENS 4x 

lees Syn SE Abo SNS en Bio OUEST ES EM Stepe Se) 


pixels 


PMP: 24s S25 Read@mmgq elle.) file trang 20006. rit, ol layer (se) a oTe S 


© Special cases with low sigma/noise ratio 


In some cases, due to high noise level, automatic registration gives wrong results by confusing noise 
and stars during star detection. To overcome this issue, Siril provides adjustable parameters offering 
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a better tool detection. These parameters are located in the Dynamic PSF window. 




















» "© Dynamic PSF 

Ch. B A x0 yo FWHMx FWHMy r Angle RMSE 
Star Detection 

Radius: | 7 _ + | 

Threshold: 

Roundness threshold: 0.6 - + | 











In this case, increasing threshold value will give better results. 


2.1.5. Stacking 


© 


In the case of C7 NGC7635 sequence, we first used the Winsorized Sigma Clipping 


algorithm in Average stacking with rejection section, in order to remove satellite tracks 
(O1y=4 and Ohigh= 3): 


“ r o Siril control center 


File Edit Image Processing Analysis Windows Help 





= 
| 
| File conversion Image sequences Pre-processing Registration Stacking Output logs 











Stacking of images, either summing, median, mean with rejection or pixel minimum/maximum. 
Sum stacking 


Stacking Methods: He 





Median stacking 


lisation: 
Normalisation: | piel maximum stacking 


Pixel minimum stacking 




















| Winsorized Sigma Clipping _ | Sigma low: 4.000 | ie EA 
Sigma high: | 3.000 | "+ 
| Stack this set of images: all the images of the sequence = 
Stack best: Based on FWHM ‘9000 | ~- lala 
Start stacking 
Store result in file: r_ deb NGC7635_stacked.fit ao Overwrite 
= 
T p for the | 
Current working directory: /nomeycyril/images/Bulle @ Stop Change dir... 
Current working sequence: r_deb_NGC7635_, 12 images selected Mem: 493MB 8 - 





The output console thus gives the following result: 


DUS ONS a a e Cle eid Ligh a a ee Oi es 
2 SOO OG PE ENT ee eon sok aane lami ila 0h, eee Aa oe 
22:26:06: Pixel rejection in channel #2: 0.133% - 1.150% 
2a ONS AONE 2 MIME EXC Mie ENE ALOl Vee ZS Sr iniercre Ss = 
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Zoe 00 SNO Male a eta eer es additive F sea En 
222 000 RP elec MON RE mn ee Winsorized sigma clipping 
22:26:06: Rejection parameters ...... low=4.000 high=3.000 


22 OO Se oa wy unc Hills MAMAN 1635 bie, siens) 222 Ox oo os moxie 
222267092 Background Noise alue Selanne Ly EE PINOT 25e 02) 
PDO Los Packoround nole value channe De TE MTS TES 04) 
22:20: 19: Background noise values (channel: F2) 6.621 (T. 010-041) 








CCE ET EEE CUS ee COUT 72 


Cet bien sapoe (deb WOLTERS 12 be 





After that, the result is saved in the file named below the buttons, and is displayed in the grey and color 
windows. 


You can adjust levels if you want to see it better, or use the different display mode. In our example the file 
is the stack result of all files, i.e., 12 files. 


Tl RGB image 





Now should start the process of the image 


Start the process of the image with crop, background extraction (to remove gradient), and some other 
processes to enhance your image. 


Here an example of what you can get with Siril 
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The purpose of the stack is the gain in signal to noise ratio. 

Note the improvement of the signal-to-noise ratio regarding the result given between the first frame 
before stacking and the result of stacking. 

Take a look to the sigma value in the example below. 


The increase in SNR is of 21/5.1=4.11*1V12=3.46 and you should try to improve this kind of result 
adjusting 0, en and 0, gh. 


© first frame 











a - o siril v0.9.5-alpha - /home/cyril/Images/Bulle 







Red channel Green channel Blue channel 












x = o Statistics 









_ | Normalized Real [0, 1] 
/home/cyril/Images/Bulle/r_deb_NGC7635_00001.fit 
Size of selection in pixel: (39,50) 



























Red Green Blue 
count (px) 1950 1950 1950 
mean 209.1 114.9 94.5 
| median 207.0 114.0 93.0 
sigma 35.9 21.0 21.5 
avgDev 27.5 16.1 16.9 
MAD 22.0 13.0 14.0 
sqrt(BWMV) 34.5 20.2 21.3 
min 8.0 0.0 0.0 
| max 385.0 216.0 179.0 

esExecute || Close 











me: | deb_NGC7635_ 


d 
Console 


the list of supported commands 


Type help for 
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@ Stacking result 


siril vO.9.5-alpha - /home/cyril/Images/Bulle 
Red channel Green channel Blue channel 


x z o Statistics 


Normalized Real [0, 1] 
/home/cyril/Images/Bulle/NGC7635.fit 
Size of selection in pixel: (26,31) 


count (px) 
mean 
median 
sigma 
avgDev 
MAD 
sqrt(BWMV) 
min 

max 





DC» À lk 





2.1.6. Process your single images 


It is one thing to process a sequence of images, and another to work on only one image, generally the 
result of this processing. This section documents the most useful features for one-image processing. 


Once you get your pre-processed and stacked image (fore more details see here), the process stage 
can Start. 


x 


These tutorials will present to you which different processes you can use, however there are no 
absolute rules. Feel free to try many processus by adjusting parameters. 
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© For example a final result is illustrated in the picture below: 





2.1.6.1. Background extraction 


When an image contains an intense light pollution, it is useful to remove it. Siril provides a "Background 
Extraction” tool in order to remove the gradient of the sky background. Siril uses a polynomial up to the 
fourth degree. The 4th degree polynomial is generally a good choice, for this model, though the tool 
allows for first to fourth degree. 


Q 


By selecting "Histogram Equalization" as display view, you can quickly check that image contains sky 
gradient due to light pollution, or in this case, Moon light. 
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RGB image 











The rainbow colormap can also help you to see the gradient: 





‘Red layer | Green layer | Blue layer) 





Q 
| 


So, this step consists to remove this sky gradient. See the operation process below 


Once you have a background model with no signal from nebula (use the display mode to 
check everything), you can apply the correction. 


Type of Extraction 


| Polynomial Interpolation + 





Correction 
Show Image 


© Show Background 


Subtraction 








@stop| | change dir| 
Mem: 451MB 
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© Two types of corrections have been implemented in Siril: 
© Subtraction 


@ Division 


RGB image 


T à 
+ aS. AIM. 
vhs 2 ae AL Le + v fe . 


- 
m 
t 


tog 
_ 
A 
~ 
> 
«% 
-$ 
- 


stele ‘hey 


MCD 





Additive phenomena like light pollution gradients should be corrected by subtraction but multiplicative 
effects like vignetting should be fixed by a division. But in the last case, the correct procedure is to 
correct the image with flat field during pre-processing step. 


Q 


After the tool were applied, you should check the background neutralization, and, maybe, apply a 
new midtone correction. 
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== Step by step background extraction 


GD Image Display 


From the > preview screen P731 choose the histogram!!! mode 





B&W layer 





| Square root 
3 | 

| Squared 

| Asinh 


2375 | p i am | i -E 
| AutoStretch — | if 


Histogra n 





oe 









“x: 201 y 514 = 2434 M45.ft (ayer O 





| | ej Min/Max N — | 
Lt ak Bless MIPS-LO/HI E Ey i = 
User 
p= rc: |, EE 
@ Show statistics 
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140 


Select an 


image area 







wh = 1.37, r = 0.81 





| a) Min/Max y l 
Ty ss 
61663) — MIPS-LO/HI of Es w = 
User 
















e conversion Image sequences Pre-processing 
This conversion tab is used to import files and convert them 
Source 


Statistics 





[| Normalized Real [0, 1] 






Ma5fit 
Size of selection in pixel: (44,29) 


Red Green Blue 
count (px) 1276 
| mean 24$4. = = 
median TT - - 
_avgDev 50.9 = = 
sigma 266.9 - - 
min 2400.0 


max 








e) Min/Max 
|] cut 61669 MIPS-LO/HI 
User 
= 2375 


© Select a second area 
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T> =. 
1 














M5 it (layer 0) whim = 1.36, r = 0.85 
fa) Min/Max ES 
{| cut 61669 MIPS-LO/HI i P m = 
User 
p= E eor eeo 

















Mas5fit 
size of selection in pixel: (40,32) 


Red Green Blue 
count (px) 1280 = | 
D mean 769.1 - -- | 
median 2757.0 
17.5 
111.8 
2738.0 
6038.0 








eo! = 0.85 
. TM ca TEE — 
61669 MIPS-LO/HI “VE Ry i = 
User 
G ne raed = og 
| i =! 






































(4) Values 


(5) Background extraction tool 


Menu =Image Processing/Background Extraction 
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Color Calibration.. nport files and convert them into a form 



































Remove Green Norse... Source 
+| Color saturation... 
Name : 

Fourier Transform... 

A trous Wavelets Transform... 

oO Convert 
Supp E] L 
IS), POM anid PPM binary images, RAW images, F 
Le Background Extraction 


Type of Extraction 


x 
O Manual © Automatic | 


A Draw boxes 
Sample Generation Interpolation 
Box radius: 50 = Degree Order: 
Box separation: 5 — + | Correction 
(¢) Show Image 
. Local Rejection 
Tolerance: 1500 — + ©) Show Background 
Unbalance: 1800 |- | + 


© Select ©OManual 
@® Select Areas 
me 


| You must select what appears to you to be the sky background. 
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i | 145. NE (lay | i fw m: no selection 
a) Min/Max a — 
(icut : 61669 MIPS-LO/HI oof E WI =| 
User 
fs = = |. = 


& Extraction 
Click on Compute 


then check @Show Background to display the result 


Background Extraction 


[| LJ =a | e conversion Image sequences Pre-processing Registration 


Box separation + 
(© Show Image 


Local Rejection 
Tolerance: (.] 5 Background 


x: 725 y: 085 = 2722 
e) Min/Max 





MIPS-LO/HI 


User 





Result 
Finish treatment 
If you're satisfied by the result check @Show Image then click on Apply and Close 
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e conversion Image sequences Pre-processing Registration 
L Or ‘ coo [0 POOL) He nd CONVOI 
Lx] Background Extraction 
| Type of Extraction 


amd | 






O Automatic Ọ Manual Clear 


|_ A 


Box radius: 20 — + | Degree Order: | 








Box separation 5 =- «> 

© Show Image 
Local Rejection 
ppd Tolerance: 1500 = $ () Show Background 
ag Global Rejection 
Deviation 2000 = + 


pat t 
eS rA | 
4 Ek + a ‘ Ed 
ee? e Tu (EU FT M - - f Fe E ce Sp DIN n sol 

OR SPS s a tee X - D A P | 
pu 


EAGLE i TS. 
x FPG  Unbalance: 1800 = + 


+ 





x: 725 y. 085 = 2722 ~ fwhm: no selection 
Min/Max 


| E FA ~ La 2 — 
f | cut 59140 MIPS-LO/HI “À =| 


User = Close | 


E 0 Earn 





| Compute | | Apply 


© 


Final result with a =AutoStrech display 











s) Min/Max 


[ | cut i 59140 MIPS-LO/HI 


User 





After extraction you can switch between image and background view in order to check the result. If you 


are satisfied you can thus apply the correction (subtraction or division). The £P subtraction operation is 
very different from the simple operation used for the darks and bias/offsets. 


Indeed, as the level of the background is identical to the one of the image, applying a simple subtraction 
would result in a image with a lot of black pixels. To avoid any inconvenience, the operation is done with 
32-bit signed integers and finally converted into native format (16-bits unsigned). 


© Sample treatment 


Following, respectively, the start image and final image (after background extraction with subtraction 
and equalization): 
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2.1.6.2. Color calibration tool 


First, we need performing a balancing of the colors of a linear RGB. Siril provides a tool of color 
calibration. 


Two steps are necessary: 


@ You must select a background area with no stars and click on "select" in the "black selection" frame. 
Click on "background neutralization" will neutralize the background by aligning median values. 


@ Inthe second step, you need to select the "white selection" area. So, make a selection containing a 
nebula part and click on apply. Be warn that black selection MUST be always selected. However, 
your image must be cropped before in order to remove any frame that could misleading the tool. 


See the complete operation process below 


== Color calibration 
The colour calibration tool performs a balancing of the colours of a linear RGB deep-sky image. 
Note that Background Equalization (now called Background Neutralization) has been moved in 
the calibration box because it is needed before any calibration. 


Prerequisite 


You must have an image in memory 


GD Open the = Color Calibration menu 
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E) Neutralizing the background 


Select a background area 





| [use current selection 


L | Background Neutralization | 
-White reference 
C Manual White Balance 
Red: { 1.000 
Green: | 11.000 
Blue: c 11.000 
Selected area 


3 Click on Use current selection 


CD Click on Background Neutralisation | 


146 





#Projet/Picty 


Remove Green Noise... 


Color saturation... 


Median Filter... 

Fourier Transform... 

À trous Wavelets Transform... 
Canon Banding Reduction... 


Geometry > | 


Background Extraction... 


Extraction 3 








/Projet/Pictu 
f 











[o “ns +] 0 ine aad + | | Use current selection | 


- Lower limit: ( 0.000 
I Upper limit: + | 0.900 





Cae Ji ww | 





File Edit Source Refactor Navigate Search Project Run Window Help 








c 
22:03:31 
22:04:12 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:15 
22:05:28 
22:05:29 
22:06:16 
22:06:26 
22:06:26 
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pe Edit Source Refactor Navigate Search Project Run Window Help 


z 
E |m 
8 | 





onpm 


BERERERERSSSEREBRRERSS 
RSSISISIRISISSSESISES 


MODMYMAARBZOZE 
iD 5 s D © à $ 
> r , 





© White reference 


Select a reference area for white balance 






) Window Help © - + 
Red layer 








Green layer 


Background reference 
Selected area 
[742 — + | [2439 = +] 





| Use current selection 


Nas = +}fiso = +] 


Background Neutralization 


White reference 
| | Manual White Balance 
Red 
Green 
Blue 


| Use current selection 





10 = + |[o 





Lower limit: (_) 0.000 









Background reference 
[z = +) = +J - + | 


(149 m + | [150 ol + | 





Background Neutralization | 


White reference 
[| | Manual White Balance 


Red; 
Green: 
Blue: 


Selected area 


iem = + m + | [1054 = + | 


233 = ẹ||330 = + 



























06/08/18 Version : 1.53 





































MIPS-LO/HI 


=...) 


Color Calibration 


siril vO.9.2 alpha - /home/lock/Projet/Pictures/Bulle 






| Use current selection 


1.000 
1.000 
1.000 

















Lower limit: C) 0.000 


Upper limit: — —(_)— 0.900 
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Background reference 
Selected area 
i la Hea | [2439 Es iái | Use current select 
149 = +/{150 = + | 
[Backoroupa Neutralization | 
reference 
[C Manual White Balance 
Red 1.00 
Green 1.0 
Blue 1.0 
Selected area 
a + |[o | Use current select 
==] f° 
Lower limit: (> 
r dell Upper limit: ==) 0.900 
App 
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o Click on Apply 


Se ee ee 


pee i 2 CE à + | Use current selection | 
= ab sms + 


| TE Te 0.000 


| Upper me S 0.900 
Clase | Ap ly | 


of three color calibration factors will be computed and multiplied with every 
for channel. 
The Background Neutralization should be applied before this operation. 


LE 86 














F72 = 187 r deb stacked.t 














Console 





je Edit Source Refactor Navigate Search Project Run Window Help 


Color Calibration 


T 742 - +|[2439 — +] 


149 = 1/150 = + 


Background Neutralization 


| Use current selection 





2 
LE 
bf n 


MIME White reference 
[C] Manual White Balance 
Red 1.000 
Green 1.000 
Blue 1.000 
Selected area 


1890 = +] [1054 - + 


nv 
15: 
:15: 
8: 
9: 
6: 
6: 


ÉERREREERE 
52253383 


:2 
:2 
tl 
:2 
:26 
:24: 





| Use current selection 





233 = + | [230 a | ` 





Lower limit: (_} 0.000 
Upper limit: ==) 0.900 





O Click on Close | to close the dialog box 
© Reducing green tint in processed images 


This tutorial shows how to remove the green tint in processed images using the graphical user 
interface. 


This function can also be accessed from the command line, with the £P rmgreen command. 


Open the =Image Processing/Remove Green Noise... menu 


Subtractive Chromatic Green Noise R.. x 


Protection method: | Average Neutral +. 





Amount: (` 1.00 
M Preserve lightness 


| Close | Apply | 


10) Click on Apply} then Close 


148 06/08/18 Version : 1.53 The free-astro development team, 2018 Siril 0.9.9 


User guide Tutorials 


Result 








2.1.6.3. Green Noise Reduction 
Last step in this processus is to reduce the green noise with the £P Remove Green Noise -391 tool. 


2.1.6.4. Midtones Function Transfer 


When you have a nice stacked and calibrated linear RGB, you can convert your image to a non-linear 


one. Siril provides an histogram transformation called Midtones Transfer Function also used in Pixinsight! 
http://pixinsight.com/doc/tools/Histogram T ransformation/Histogram Transformation.html] By adjusting midtones sliders 


and shadows sliders iteratively (generally we do not use the highlight sliders) you will apply the 
histogram transformation. Pay attention to not clip to much pixels. Although Midtones Function Transfer 
is very similar to Gamma curves adjustment, they are not identical. 


ndows elp 
es Preprocessing Registration Stacking Output logs 


Selection 
Clip (%) 


_ 0.14778 


0.41379 
es 


1.00000 


Apply stop | Change dir 
Mem: 305M8 





histogram redraw 


2.1.7. Manual Registration 


In some case, manual is the best way to register sequences images. 


== 


ED Sequence selection 
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siril vO.9.5-alpha - /home/cyril/Images/Crosse/Luminance_binning_1x1 


B&W channel 
pp_crosse-001.fit 


pp_crosse-002.fit 
pp_crosse-003.fit 
pp_crosse-004.fit 
pp_crosse-005.fit 
pp_crosse-007.fit 
pp_crosse-008.fit 
pp_crosse-009.fit 


on ove wn + 


pp_crosse-010.fit 


© 


pp_crosse-011.fit 
pp_crosse-012.fit 
pp_crosse-013.fit 
pp_crosse-014.fit 
pp_crosse-015.fit 
pp_crosse-016.fit 


H bé e e mb 
vu ke wWwNnNe © 


pp_crosse-017.fit 


em 
a 


pp_crosse-018.fit 


FE 


siril vO.9.5-alpha - /home/cyril/Images/Crosse/Luminance_binning_1x1 


B&W channel 
pp_crosse-001.fit 


pp_crosse-002.fit 
pp_crosse-003.fit 
pp_crosse-004.fit 
pp_crosse-005.fit 
pp_crosse-007.fit 
pp_crosse-008.fit 
pp_crosse-009.fit 
pp_crosse-010.fit 
pp_crosse-011.fit 
pp_crosse-012.fit 
pp_crosse-013.fit 
pp_crosse-014.fit 
pp_crosse-015.fit 
pp_crosse-016.fit 
pp_crosse-017.fit 
pp_crosse-018.fit 


Image reference 


Set image reference first 
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File Edit Image Processing Analysis Windows Help 


File conversion Image sequences Pre-processing Registration Stacking Output logs 


images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out 


Sequence selection 
Sequence: | pp_crosse-.seq Search sequences 
_) force .seq recomputation 


Image selection in sequence 


<pp_crosse-.seq>: 17 images selected out of 17, no reference image set 


001 + excluded reference image 


exclude all include all 


Sequence export 


Base name: Export sequence 


_} Normalize images 


Current working directory: /home/cyril/Images/Crosse/Luminance_binning_1x1 @Stop Change dir... 





Current working sequence: pp_crosse-, 17 images selected Mem: 88MB 


Siril control center 


File Edit Image Processing Analysis Windows Help 


File conversion Image sequences Pre-processing Figgistration Stacking Output logs 


Registration is basically aligning the images from a sequence to be able to process them afterwards 
Image registration 


e) Register all images from sequence Register selected images only 


Choose registration method: One Star Registration (deep-sky) Select registration layer 0: Luminance v 
Select an area in image first 


Manual registration 


Set reference image first Set first preview Set second preview 


X translation: - + Y translation: 0 _|+ 


Current working directory: fhome/cyril/images/Crosse/Luminance_binning_1x1 @ Stop Change dir... 





Current working sequence: pp_crosse-, 17 images selected Mem: 88MB 
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pp_crosse-001.fit 
pp_crosse-002.fit 
pp_crosse-003.fit 
pp_crosse-004. fit 
pp_crosse-005.fit 
pp_crosse-007.fit 
pp_crosse-008. fit 
pp_crosse-009.fit 
pp_crosse-010.fit 
pp_crosse-011.fit 
pp_crosse-012.fit 
pp_crosse-013.fit 
pp_crosse-014.fit 
pp_crosse-015.fit 
pp_crosse-016.fit 
pp_crosse-017. fit 
pp_crosse-018.fit 


pp_crosse-001.fit 
pp_crosse-002.fit 
pp_crosse-003. fit 
Pp_crosse-004. fit 
Pp_crosse-005.fit 
pp_crosse-007.fit 
pp_crosse-008.fit 


pp_crosse-009.fit - 


pp_crosse-010.fit 
pp_crosse-011.fit 
Pp_crosse-012.fit 
pp_crosse-013.fit 
pp_crosse-014.fit 
pp_crosse-015.fit 
pp_crosse-016.fit 
Pp_crosse-017.fit 
pp_crosse-018.fit 


pp_crosse-001.fit 
pp_crosse-002.fit 
pp_crosse-003.fit 
pp_crosse-004.fit 
pp_crosse-005.fit 
pp_crosse-007.fit 
pp_crosse-008.fit 


pp_crosse-009.fit - 


pp_crosse-010.fit 
pp_crosse-011.fit 
Pp_crosse-012.fit 
pp_crosse-013.fit 
pp_crosse-014.fit 
Pp_crosse-015.fit 
pp_crosse-016.fit 
pp_crosse-017.fit 
pp_crosse-018.fit 
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siril vO.9.5-alpha - /home/cyril/Images/Crosse/Luminance_binning_1x1 


B&W channel 


siril vO.9.5-alpha - 


B&W channel 


siril vO.9.5-alpha - 


B&W channel 


R 


broad 


home/cyril/Iimages/Crosse/Luminance_binning_1x1 


home/cyril/images/Crosse/Luminance_binning_1x1 


C > A 


A O 
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File Edit Image Processing Analysis Windows Help 


File conversion mage sequences Pre-processing 


Images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out. 


Registration Stacking Output logs 


Sequence selection 


Sequence: | pp_crosse-.seq Search sequences 


{_) force .seq recomputation 


Image selection in sequence 


<pp_crosse-.seq>: 17 images selected out of 17, no reference image set 


001 + excluded reference image 


exclude all include all 


Sequence export 


Base name Export sequence 


_] Normalize images 


Current working directory: fhome/cyril/images/Crosse/Luminance_binning_1x1 @ Stop Change dir... 


Current working sequence: pp_crosse-, 17 images selected Mem: 88MB 8 - 


Siril control center 
File Edit Image Processing Analysis Windows Help 


File conversion Image sequences Pre-processing Registration Stacking Output logs 


images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out. 


Sequence selection 


Sequence: | pp_crosse-.seq Search sequences 


[ | force .seq recomputation 
Image selection in sequence 
<pp_crosse-.seq>: 17 images selected out of 17, reference image is 009 


009 + excluded que image 


exclude all include all 


Sequence export 


Base name Export sequence 





__] Normalize images 


Current working directory: fhome/cyril/images/Crosse/Luminance_binning_1x1 @ Stop Change dir... 





Current working sequence: pp_crosse-, 17 images selected Mem: 104MB 


Siril control center 
File Edit Image Processing Analysis Windows Help 


File conversion Image sequences Pre-processing Registration Stacking Output logs 


images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out 


Sequence selection 


Sequence: | pp_crosse-.seq Search sequences 


[ | force .seq recomputation 
Image selection in sequence 
<pp_crosse-.seq>: 17 images selected out of 17, reference image is 009 


009 + excluded uns image 


exclude all include all 


Sequence export 


Base name Export sequence 





__] Normalize images 


Current working directory: /home/cyril/images/Crosse/Luminance_binning_1x1 @ Stop Change dir... 





Current working sequence: pp_crosse-, 17 images selected Mem: 104MB 





Siril 0.9.9 


151 


Tutorials User guide 


O settirst preview 


siril vO.9.5-alpha - /home/cyril/Images/Crosse/Luminance binning 1x1 


B&W channel 


pp_crosse-002.fit 


pp_crosse-003.fit = 
= Siril control center 


pp_crosse-004. fit 

: : 
pp_crosse-005.fit File Edit Image Processing Analysis Windows Help 
pp_crosse-007.fit - , . fi File conversion Image sequences Pre-processing Registration Stacking Output logs 


pp_crosse-008.fit 


pp_crosse-009.fit Registration is basically aligning the images from a sequence to be able to process them afterwards. 


pp_crosse-010.fit Image registration 


pp_crosse-011.fit - e) Register all images from sequence Register selected images only 


pp_crosse-012.fit 
pp_crosse013fit - . Choose registration method One Star Registration (deep-sky) Select registration layer 0: Luminance w 


pp_crosse-014.fit 

Select an area in image first 
pp_crosse-015.fit 
pp_crosse-Ol6.fit - | g Manual registration 


pp_crosse-017.fit 
~ display reference image Set fir preview Set second preview 
pp_crosse-018.fit 


X translation Y translation: 0 


Current working directory: /home/cyril/images/Crosse/Luminance_binning_1x1 @ Stop Change dir... 





Current working sequence: pp_crosse-, 17 images selected Mem: 121MB 








File conversion Image sequences Pre-processing Registration 


Image registratior 


Manual registration 


siril vO.9.5-alpha - /home/cyril/Iimages/Crosse/Luminance binning 1x1 


B&W channel 


pp_crosse-002.fit 


pp_crosse-003.fit = 
Siril control center 
pp_crosse-004.fit 


pp_crosse-005. fit File Edit Image Processing Analysis Windows Help 
pp_crosse-007.fit ° . 1 File conversion Image sequences Pre-processing Registration Stacking Output logs 


pp_crosse-008.fit 


trat Das Ih ni the images m a sequence to abi roces m terwards 
pp_crosse-009.fit Registration is basically aligning the images from a sequence to be able to process them afterwan 


pp_crosse-010.fit Image registration 


pp_crosseO11.fit - e) Register all images from sequence Register selected images only 


H O©OOnN OY BR WN 


pp_crosse-012.fit 
pp_crosseO13fit - r . Choose registration method One Star Registration (deep-sky) Select registration layer 0: Luminance w 
pp_crosse-014.fit 

Select an area in image first 
pp_crosse-015.fit 
PP_crosse-016. fit - Manual registration 
pp_crosse-017.fit 


# display reference image Set first preview Set sax | preview 


pp_crosse-018.fit 


X translation: Y translation 0 


Current working directory: /home/cyril/Images/Crosse/Luminance _binning_1x1 @ Stop Change dir... 





Current working sequence: pp_crosse-, 17 images selected Mem: 121MB 
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Image registration 


Select an area in image first 


Manual registration 


LA f Set first preview et secor 





(7) X translation 


Manual registration 


|w] display reference image Set first preview Set second preview 


X translation: Le $ + Y translation: 0 —- + 








©) Y translation 


Mana E T 


|+ display reference image Set first preview Set second preview 





X translation: -B — + ¥ translation: -12 = + 


siril vO.9.5-alpha - /home/cyril/Images/Crosse/Luminance binning 1x1 
file B&W channel 
pp_crosse-001.fit 


pp_crosse-003.fit SE 

= x - o Siril control center 
pp_crosse-004.fit 
pp_crosse-005. fit File Edit Image Processing Analysis Windows Help 


pp_crosse-007 fit File conversion Image sequences Pre-processing Registration Stacking Output logs 


pp_crosse-008.fit 


pp_crosse-009.fit Registration is basically aligning the images from a sequence to be able to process them afterwards 


pp_crosse-010.fit Image registration 


oon owe wn 


pp_crosse-011.fit e) Register all images from sequence Register selected images only 


pp_crosse-012.fit 


pp_crosse-013.fit Choose registration method: One Star Registration (deep-sky) X Select registration layer: 0: Luminance v 
pp_crosse-014.fit 
Select an area in image first 
pp_crosse-015.fit 


pp_crosse-016.fit Manual registration 
pp_crosse-017.fit 


0/00 o'o olio olol 0l olola olo 


# display reference image Set first preview Set second preview 
pp_crosse-018.fit 


X translation Y translation: 119 


Current working directory: fhome/cyril/images/Crosse/Luminance_binning_1x1 @Stop Change dir... 


Current working sequence: pp_crosse-, 17 images selected Mem: 122MB 8 - 
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siril vO.9.5-alpha - /home/cyril/Images/Crosse/Luminance_binnin 


B&W channel 
_crosse-001fit - - 


Siril control center 


File Edit Image Processing Analysis Windows Help 


File conversion a S Pre-processin g Registration Stacking Output logs 


ONY anerwnroyx | 


Registration is basically aligning the images from a sequence to be able to process them afterwards 


Image registration 


by) da OT |] viols 


e) Register all images from sequence Register selected images only 


Choose registration method One Star Registration (deep-sky) X Select registration layer 0: Luminance v 


ren 


Select an area in i 


ower OM © WwW 


Manual registration 
= Set first preview Set second preview 
crosse-018.fit 13 


Y translation: 


Current working directory: /nome/cyril/images/Crosse/Luminance_binning_1x1 @Stop Change dir... 





Current working sequence: pp_crosse-, 17 images selected Mem: 123MB 8 - 





DC» A lk ui 


10) Stacking 


2.1.8. Aperture photometry 


Prerequisite 


Á Gnuplot is needed 


Gnuplot!tte-/onuplot.sourcetorge.nev/] is a portable command-line driven graphing utility for Linux 


T®) 


lf you use Ubuntu or Mint click on the link below 


Gnuplot/Pt/onuploi] 


GD Convert your images in a sequence 


2) when preprocessed images 
Q 


You can even consider making a cosmetic correction in addition to that proposed automatically 
with the the dark subtraction. 


Menu =Image processing/Cosmetic Correction... 
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Cosmetic Correction 








Auto detection 
Cold Sigma: | 3.00 ii | 
Hot Sigma: | 3.00 ii | 
Amount: | 1.0 
(_) CFA 
| Apply to sequence Output prefix: fec | 


_ Close || Apply | 





OG Demosaicing (for Bayer-Pattern images only) 
: x It is recommended to only work on the green channel, demosaiced with super 


pixel algorithm. 


Settings 


DSLR RAW debaver Oth *"* z “Optics Photomet Misc. 
y Bilinear | P ry 


Debayer Nearest Neighbor 
Bayer pattern from f yryc 











Bayer/mosaic pattern: | AHD 


Debayer interpolation: 


(| Ensure KSTARS/EKOS compatibility 








OK 


Do not use other algorithms that would introduce artifact due to interpolation. 


D 
| The red layer is strongly noised by the light pollution and the blue layer by atmospheric refraction. 


x 
Aperture photometry compares stars of the same image, keeping the green layer is the best 


choice. 


(a) Images registration 


& 
| Working on an registered images sequence is a better choice 


06/08/18 Version : 1.53 The free-astro development team, 2018 Siril 0.9.9 155 


Tutorials User guide 


Q 
Use either One Star Registration or Global Star Alignment in this case check M 
Translation only 


Ls - E siril v0.9.6-beta4 - /home/cyril/Images/exoplanete 2 





x Fenêtre gnuplot 0 


THARA A 


——Eourbe de luminosité 











It 
| | 
| i iL 
A gat 


Hell 





ae nie: 


a 

















(D) 2457670 + 
0.338918, -1.70733 





© Export the sequence 
© Load the sequence 
o Select variable star 


siril vO.9.6-betaq | Centre de contrôle de Siril 


- N&B 







Conversion Sequence Pre-traitement Alignement Graphique Empilement Sortie de console 
— 





Magnitude de l'étoile (relative, utilisez "setmag") 


=r 4 i 4 





10401 LRAT (24212 


o Fenêtre gnuplot 0 
-CHARAS 


Courbe de luminosité 











i 0.24 0.25 0.26 027 0.28 0.29 0.3 0.31 0.32 0.33 0.34 0.35 
UD) 2457412 + 
0.240585, -0.325566 








You have to make a fairly wide selection, 
It is necessary to check that the largest circle is completely included. 
All parts of the circle outside the selection will be ignored. 


(©) Once the selection has been made, 
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check with the statistics option that the maximum is not 65535 


siril vO.9.6-beta3 - /home/laurent/Documents/traitement 


B&W channel 





Statistics 


Crop Sequence... 





Red x: 0707 y: 0428 = 0431 dypeg6 00001.fit (channel 0) Fwhm = 8.56, r= 0.94 
cut = | 1479 | Min/Max 
~ © MIPSLO/HI 
æ 4) 279 User 


$ fr = AX LL, fe Ry Linear Le Zoom to fit + 
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ky 
Statistics 
[|] Normalized Real [0, 1] 
Image 0/46 From the sequence dypegé_ 

Size of selection in pixel: (98,77) | 

Red Green Blue 
count (%) 100.0000 - — 
min 301.0 - - 
max 2928.0 = = 

Execute | | Close | 











A 
_ If the value is 65535, the star is saturated. 
_ The results will be inoperable. 


© Do a PSF for sequence 
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User guide 
siril vO.9.6-beta3 - /home/laurent/Documents/traitement 
B&W channel 
PSF 
PSF For the sequence N 
Pick a Star 
Statistics 
Crop Sequence... 
Red x: 0699 y: 0417 = 0405 dypeg6 00001.fit (channel 0) Fwhm = 8.59, r=0.94 
IE 1479 Min/Max 
= _ © MIPS-LO/HI 
=æ 4) 279 User 
n fr = AX A, ft Linear ¥ Zoom to fit + 
= 
| A median filter is applied to the selection in order to remove hot pixels that could lead to bad star 


detection. 
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siril vO.9.6-beta3 - /home/laurent/Documents/traitement 


B&W channel 








Red x: 0529 y: 0124 = 0351 dypeg6 00001.fit (channel 0) fwhm: no selection 
cut = 1479 Min/Max 
© MIPS-LO/HI 
ee 21? User 


$ i — AX LL, af E Linear id Zoom to fit + 


10) Then we look for stars with a close magnitude 


( S 


To help you, when you make the selection, look at the bottom right of the image the value of the 
FWHM which must be close to the FWHM value of the variable star. 
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© Here the value is 8.56 for the variable star. 


siril v0.9.6-beta3 - /home/laurent/Documents/traitement 


B&W channel 








Red x: 1369 y: 0309 = 0360 dypegé 00001.fit (channel 0) Fwhm = 8.49, r =0.95 
| cut = 1479 Min/Max 
© MIPS-LO/HI 
= « 279 User 


a ir — A A, af E Linear id Zoom to fit + 


aD Check with Statistics tool that the selected star is not saturated 
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B&W channel 





Statistics 
Normalized Real [0, 1] 
Image 0/46 from the sequence dypeg6_ 
Size of selection in pixel: (64,55) 
















Red Green Blue 
count (%) 100.0000 -= = 
count (px) 3520 - - 
mean 485.5 = -- 
median 366.0 = = 
sigma 615.8 - - 
avgDev 133.8 _ - 
MAD 13.0 — ~- 
sqrt(BWMV) 19.3 - g 
min 285.0 - = 
max 5769.0 = — 
Execute Close 
Red x: 0029 y: 1140 = 0363 ~ dypeg6 00001.fit (channel 0) Fwhm = 8.49 r = 0.95 
cut 1479 Min/Max 


The values given by the statistical tool only concern the open image, not the entire sequence 
of images. 


B Doa PSF for sequence 
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siril vO.9.6-beta3 - /fhome/laurent/Documents/traitement 


B&W channel 








Red x: 0009 y: 0220 = 0364 dypeg6 00001.fit (channel 0) Fwhm = 8.49, r=0.95 
cut = 1479 Min/Max 
© MIPS-LO/HI 
sé 279 User 


i, fr — A LL, af Ej Linear id Zoom to Fit ¥ 


13) Repeat previous steps for 3 or 4 more stars 


( ` 
\/ 


If a curve of a reference star appears suspicious, click on delete the last curve and choose 
another star. 
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siril vO.9.6-betad - ER LE 


B&W channel 





Red x: 0681 y: 0002 = 0352 dypeg6 00001.fit (channel 0) Fwhm = 8.35, r=0.96 
] cut = 1479 Min/Max 
——— © MIPS-LO/HI 
=æ {] 279 User 


DC» À L on) ni 





14) In the |plot| tab select Magnitude | 


Siril control center N 


File conversion Sequence Pre-processing Registration Plot Stacking Output logs 





Star magnitude (relative, use setmag) 


15903 0 269959 204016 0.318 


(JD) 2457412 + 





Filename: | Plot Export to CSV | Clear all || Clear latest || Plot Var. Magnitude + || Photometry v 
Console 
Type help For the list of supported commands 


Finished computing PSF for the sequence. Ready. 


mn 
Current working directory:/home/laurent/Documents/traitement @Stop |. | Change dir... 


Current working sequence: dypeg6_, 46 images selected Mem: 96MB 4 |— 
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ae Click on Plot Var) 


Gnuplot window 0 $ 
: P°-ORAQAQAQ SP 


Light Curve 


-1 





-0.3 
0.24 0.25 0.26 0.27 0.28 0.29 0.3 0.31 0.32 0.33 0.34 0.35 


(JD) 2457412 + 
0.319901, -1.07319 


X 
X axis: Julian Day 
@ format: geocentric based on UTC 


Y axis: magnitude difference: 
@ Magnitude of the variable - magnitude of the super star. 


@ The super star is the star constructed from the stars of reference. 
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Result 







tilisez "setmag") 
D 2 o 
|| Q D 
T 
qe 
> 
: D 
mi, 
> A 
® 
3 
2 
g 
® 
® 
a 
© 
= S 
a à 
g 
4 3 
® 
c 
® ® 
u 
$ 
L] 
o 
2 
\\ ° 
z 
o 
0 
© 
2 
Ÿ 


Magnitude de l'étoile (relative, utilisez " â 


ii à di 
Fenêtre gnuplot 0 


-CHARA 7 


Courbe de luminosité 








4 
0.24 O25 026 O27 0.28 0.29 0.3 0.31 0.32 0.33 0.34 0.35 
(D) 2457412 + 
0.240585, -0.325566 





General comments 


# An error may occur 








x = oO Gnuplot window O 


"CHAR / 











Light Curve 





0.24 0.26 0,28 0.3 0,32 0.34 0.36 0.38 0.4 
(JD) 2457013 + 
0.400867, -20.5304 | 
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For an unknown reason, the error on the magnitude could not be determined and is therefore given 
the value 9.99 


We calculate the magnitude with the old algorithm much less reliable but that can not fail. 


The error remains at 9.99. 


Q 


You have to understand why: look at the console 


12:50:14: Inner and outer radii are too small. Please update values 
ONE ve Linke; Dox. 
12:50:14: Inner and outer radii are too small. Please update values 


Ine CCI oxo 


® Change settings and try again 


Settings 





DSLRRAW debayer Otherdebayer Camera&Optics Photometry Misc. 


Camera 
ADC gain: | 2.30000 — +] 
Background 
Size of the annulus For background level measurement (pixels): K 
Inner radius: (20.00 — +| 
Outer radius: (30.00 — +) 


_ | Restore to Default | 


OK 





2.2. Planetary 


2.2.1. Use SER files 


Open the file 
Menu =File/Open File 
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Cancel 


© Recent 
| tt Home 
| D Documents 
+= © Images 
dd Musique 
J Ÿ Téléchargements 


IQ wm Vidéos 


| Œ Volume de 31 GB 


nt + Other Locations 





SER files (*.ser) 


4 [mm usb-Kingston_DataTraveler_3.0_60A44C426697BF60D9813C79-0:0-part1 


Open File 


4 | laurent | Documents | astro | > 


= ZWO ASI224MC_223320.ser 2.2GB Mon 


0- files 


iT (*.ser) 





Select SER files (* .ser) from the dropdown menu 





2 = 


Open 


Click on Open) once the file selected 
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Cancel Open File 


© Recent 4 | flaurent | Documents | astro | > 


tf Home 


= ZWO ASI224MC_223320.ser 2.2GB Mon 
Documents 


D 
© Images 
dd 


Musique 

Téléchargements 

Vidéos 
usb-Kingston_DataTraveler_3.0_60A44C426697BF60D9813C79-0:0-part1 


Volume de 31 GB 2 


Other Locations 





SER files (*.ser) 


Siril control center 
File Edit Image Processing Analysis Windows Help 


Image sequences 


Images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out. 


Sequence selection 


Sequence: | ZWO ASI224MC_223320.ser Search sequences 


force .seq recomputation 


Image selection in sequence 
</home/laurent/Documents/astro/ZWO ASI224MC_223320.seq> : 601 images selected out of 601, no reference image set 


0 + excluded reference image 


exclude all include all 


Sequence export 


Base name: FITS v Export sequence 


v Normalize images 


Console 


Current working directory: /home/laurent/Documents/astro @ Stop Change dir 


Current working sequence: ...aurent/Documents/astro/ZWO ASI224MC_ 223320, 601 images selected Mem: 83MB | 4 — 





The SER files are converted on the fly in sequences 
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2.2.2. Usual planetary processing (avi) 


= Avi planetary processing step by step 


Support for films such as AVI has been dropped and many functions of Siril will not work for 
them, in favour of the SER format. This version of Siril provides a way to convert films into SER 
sequences, on which all Siril processing functions are supported. 


GD open file 


Go to the =File/Open menu 
In the file type selection list choose Film Files (*.avi,*.mpg....) 










© File select 





Select the AVI file to be processed and click Open 








© reference image 
Go to the Registration tab 


(4) Registration 


Set Image Pattern Alignement (Planetary - Full Disk), as Registration method 











Image registration 


Manual registration 


©) Sélection 
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Go to the preview window and select the area around the planet 





© Image de référence 


Click on Go registrer 


Siril control center 











In the Output tab logs will point you to the best picture 


EC 








Best frame : here #11 
(7) reference image 


Go to the preview window, display the image list = 


Select the best picture with a double click 





— COL SBE s 
am 





©) reference image selection 


Go to the tab M Images sequences then check reference image 





Image sequences 


© Registration 
Go to the tab Registration and click on Go register 








10) Stacking 


Use Sum stacking with avi FILES 
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Choose best images, automatically selected from registration data ( Planetary ) 
Choose the % of images to use, depending on the quality level referred 


Click on Start stacking) 
Sea 


t 











D Extraction of RGB channels 


Go to the Image menu =Processing/Extraction/Channel... 
Choose r in Channel #1 


v in Channel #2 et b in Channel #3 


Channel Extraction 
Color Space: RGB 
Channel #1: | r 


Channel #2: | v 





Channel #3: | b 


Close Apply 


Click on apply 





12) Image compositing 
Goto the =Image Processing/RGB Compositing 
Choose files previously created for red, green and blue 


Choose Image pattern alignment (planetary/deep-sky) | 





Select an area around the planet in the pre viewing window and then click on Align 





Layer alignments 


Cliquez sur Close 


B flip your image if needed 


Then save it 
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14) wavelet processing 


Load your saved image 


Menu =Image Processing/ À trous Wavelets Tranform... 








a Traitement 


Click on Execute) 





Make your settings 





ril v0.9.3 - /home/laurent/Documents/Traitement 


een layer 


jupiter.fit (layer 1) 
Min/Max 
og 
2122 |) MIPS-LO/H| Se 





16) Save file 


Click on ok) close the wavelet dialog box 


Menu =file/Save as... and choose the saving format 


2.2.3. Align RGB channels 


At the end of the stack, Siril provide an option to automatically align RGB channels. 
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== Automatically align RGB channels 
GD At the end of the stack, 


select an area in [Agray scale image windows 





siril vO.9.5-alpha - /media/laurent/LaCie/SharpCap Captures/2016-07-26/Capture 


Red channel Green channel Blue channel 





Green X: 235 y: 000 = 00000 Unsaved stacking result (channel 1) fwhm: selection is too large 


MIPS-LO/HI 
aa, 0 User 


i, re > AX vA af w Linear v Zoom to fit v 


@ Then in color image windows 
Right click to open pop up menu 


RGB image 


Save RGB image to 48-bit FITS 

Save RGB image to 24- or 48-bit TIFF 
Save RGB image to 24-bit BMP 

Save RGB image to JPG 

Save RGB image to 48-bit PPM 


RGB Align > Image pattern alignment (planetary/deep-sky) 


One star registration (deep-sky) 





© Select =RGB align 
A) Choose Image pattern alignment or one star registration. 


In most of the cases use Image pattern alignment. 


Q 


You can align with a star or a Jupiter's satellite for example with one star registration 
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Result 
The RGB channels alignment is done 


ii S2259: Recomputing already -xioting registration for this layocr 
127726 TREI otroc On FIn Shed: 
IS 32240 Beck rane 0 


2.2.4. Archiving planetary videos 


Siril allows you to export a user-defined percentage of the best images from a SER video. 


GD Go to the |Sequences tab 


File Edit Image Processing Analysis Windows Help 


Images are manipulated in sequences. Sini can find sequences in CWD, and you can filter images out. 
Sequence selection 


w 


[| Force .seq recomputation 


Image selection in sequence 


No sequence 


D exc C) reference image 
| excludeall all | include all all 


Sequence export 


w Cf 


| | Normalize images Select area to crop 


Image selection uses the same controls as for stacking 


Type help For the list of supported commands 


Ready. 


Current working sequence: - none - 


O Select the file Ser or Avi to archive 
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Th L CENL 


ons Co M LR it 


“File Edit Image Processing Analysis ee Help 








Elle convession Sequence | Pre-processing | Registration Plot | Stacking | Output logs 


Images are manipulated in sequences. Sin can find sequences in CWD, and you can filter images out. 
Sequence selection 


[_] Force .seq recomputation 


Image selection in sequence 
No sequence 


acte 
| excludeall all | include all all 


| | reference image 


Sequence export 
se name (d= | 


| | Normalize images Select area to crop 


Image selection uses the same controls as For stacking 


Type help For the list of supported commands 


Ready. 
D 


Mem 64ME 


Current working directory: /home/laurent/Documents/traitement 


Current working sequence:- none - 





File Edit Image Processing Analysis Windows Help 
= : 
File conversion | Sequence Pre-processing | Registration Plot | Stacking Output logs | 
Images are manipulated in sequences. Siril can find sequences in CWD, and you can filter images out. 
Sequence selection 


Sequence: | Moon-20170407_213157_CEST-Light.seq < 


Image selection in sequence 
<Moon-20170407_213157_CEST-Light.seq>: 8107 images selected out of 8107, no reference image set 
0 = | (J excluded 


J | 

















| exclude all 





include all ] 


Sequence export 
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sean (i ] 


[ Export sequence | 





[C] Normalize images 





Image selection uses the same controls as for stacking 


Select area to crop 


Go to the stacking tab 

















a @ Min/Max 


O MIPS-LO/HI 











Current working directory: /home/laurent/Documents/traitement 


Current working sequence: Moon-20170407_213157_CEST-Light, 8107 images selected 





Mem: 77MB 


© Register your sequence if you have not already done. 


CD Go to the |Stackingt| tab 
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File Edit Image Processing Analysis Windows Help 


Stack best Based on quality > 0.35 (7297 images) 


| Type help For the list of supported commands 


Current working sequence: Moon-20170407_213157_CEST-Light, 8107 images selected 





CS) Choose best images, automatically selected from the alignment 
Into maton (Panela). 
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File Edit Image Processing Analysis Windows Help 


conversion | Sequence | Press | Registration Piat stacia Out lps 


Additive with scaling ~ |[ |] Force recomputing 


Stack this set of images: all the images of the sequence + 


Stack best Based on quality > 0.35 (7297 images) 5000 | = | ae |% 


Store result in file: | Moon-20170407_213157_CEST-Light_stacked.fit 


Type help for the list of supported commands 


Current working directory: fhome/laurent/Documents/traitement 


Current working sequence: Moon-20170407_213157_CEST-Light, 8107 images selected 





© Choose the quality of images to keep 
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Sequence stacking 


Additive with scaling ~ |[ |] Force recomputing 


Stack this set of images: best images, automatically selected From the registration data (Planetary) a 


Stack best Based on quality > 0.69 (973 images) 


Store result in file: | Moon-20170407 213157 CEST-Light stacked.Fit 


Type help For the list of supported commands 


oo STS 


C.. 
Current working sequence: Moon-20170407_213157_CEST-Light, 8107 images selected Men: T7MB 





@ Back to the |Sequences| tab 


© Enter a name in Base Name 
© Choose the SER format to export the sequence 
10) Click Export Sequence 
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File Edit Image Processing Analysis Windows Help 
images are manipulated in sequences. Sini can find sequences in CWD, and you can filter images out. 
Sequence selection 


Sequence: | Moon-20170407_213157_CEST-Light.seq ¥ 


[| Force .seq recomputation 


Image selection in sequence 


<Moon-20170407_213157_CEST-Light.seq=: 8107 images selected out of 8107, no reference image set 


«de Cenc D) reference image 


Sequence export 


sserane 


C] Normalize images Select area to crop 


Image selection uses the same controls as for stacking 


| Type help for the list of supported commands 


Current working sequence: Moon-20170407_213157_CEST-Light, 8107 images selected 
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Result 


The sequence is exported 


Images are manipulated in sequences. Sinl can find sequences in CWD, and you can filter images out. 
Sequence selection 


Sequence: | Moon-20170407 213157 CEST-Light.seq 


Image selection in sequence 
<Moon-20170407 213157 _CEST-Light.seqz: 8107 images selected out of 8107, no reference image set 


[C excluded C] reference image 


Sequence export 
pase rame 


C] Normalize images Select area to crop 


Image selection uses the same controls as For stacking 


Type help For the list of supported commands 


Processing image 1714 from Moon-20170407 213157 _CEST-Light.ser 


-|+ 


Current working sequence: Moon-20170407_213157_CEST-Light, 8107 images selected Men: TTMB 





Q 


You will find the file in the current working directory 
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Authors 


Vincent/itps/free-astro.org/index php/User. Vincent]; a computer scientist (PhD) and uses Siril as an amateur 
to process images from a Canon EOS, a QSI and a Basler camera on a 410mm telescope. 

Cyril tps: Mree-astro.org/index.php/User-Lock42] is à physicist (PhD), now IT engineer at CNRS motivating new 
developments and providing high quality processing algorithms to Siril. 

Laurent is a senior IT project manager and also uses Siril to process images from a Canon EOS and a 
ZWO camera on a 250mm telescope. He manages the formatting of the documentation, using Scenari" 
ps.//scenari.org/] technolo gy. 


François Meyer wrote the initial (up to v0.8) versions. Here are the legacy Sourceforge project!P:/sourcet 
orge.net/projects/siril/| and websitel/Mlie-/aulle. free. fr/alidade/siril.php ?lan=en] 


See the AUTHORS/Mps.Mree-astro.org/svn/sini/trunk/AU THORS] file for the complete list of contributors. 
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Glossary 
2D Gaussian 
—( (x=x0) , O0), 
20° 20° 
G(x,y)=B+Ae ‘ r 
2D Gaussian 
(LC), OI) 
20° 20° 
G(x,y)=B+Ae ‘ ‘ 
A BIAS frame is an image taken with the shutter closed and the shortest possible 
= offset exposure time. Basically it corresponds to an exposure of 1/4000s 
with modern DSLRs. The BIAS shows the electronic noise and 
readout signal of the camera and the more BIAS exposures are used 
for the calculation of the master BIAS, the less noise will be 
introduced into the corrected images. Note that BIAS frames MUST 
be taken at the same ISO than light frames. 
Adaptive Homogeneity- The direction to interpolate is chosen to minimize the level of color 
Directed artifacts. 
= AHD Due to the rectangular sampling lattice in Bayer pattern, interpolation 
is performed in horizontal and vertical directions only . 
Directional interpolation uses filterbank techniques to cancel aliasing 
from CFA sampling. 
addmax addmax filename 
addmax compute a new image IMG with IMG_1 and IMG_2. The 
pixel of IMG_1 is replaced by the pixel at the same coordinates of 
IMG_2 if the intensity of 2 is greater than 1. 
ADU There are several concepts and issues going on here that are getting 
= Analog Digital Unit mixed together. 
= Binary Number First the ADC 
= Digital Count An ADC (Analog To Digital Convertor) takes signal values in a certain 
range and converts then to a digital number. Let's run some numbers: 
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A N bit ADC will be able to represent 2“N states. So a 4 bit ADC can 
represent 16 distinct states, 8 bits => 256 States and a 12 bit 
convertor will give you 4096 states. By itself that tells you nothing, you 
need to know that going from a digital representation of say 533 -> 
534 means that the input signal changed by certain amount. To keep 
the example simple l'm going to say that | have an input range from 0 
Volts to 4.095 Volts on a 12 bit convertor, that means that when | 
have a digital number of 0 then | must have had 0 on the input. Let's 
also assume everything is ideal for now. With my sneaky choice of 
input range you can see that for every change in the ADC output 
digital number by one count then the input must have changed by 1 
mV. 


Why did | pick 4.095? Well a 12 bit convertor will have 4096 digital 
values that range from 0 to 4095 (2^N-1 when all the bits are set to 
"1"). So 4.095 Volts/4095 = 1 mv/count. That means that if you have a 
3.567 Volt value on the output and it changes to 3.568 Volts ( 1 mV 
change on the input) then the digital number on the output should 
change from 3567 to 3568 digital number on the output from 
110111101111 to = 110111110000 in raw binary. 


Each of these binary steps are called an ADU (Analog Digital Unit) or 
Binary Number or Digital Count etc. etc. to keep it separate from the 
number of bits that the ADC has. This is to ensure that the 
relationship is in a linear range. If you start using "bits" then itis ina 
logarithmic range (2“N). The main reason these other names/units 
are used is that LSB's used to be used. What is a LSB? - it stands for 
Least Significant Bit, i.e. the zeroth bit in the digital number, which 
changes precisely in step with the ADU but using LSB (and the 
implied 'bit") is confusing. Imagine saying, " the ADC changed by 30 
LSB's therefore the light flux must have changed by 3000 photons ". 
30 LSB's really doesn't make sense, it is a mixing of terminology, so 
people are moving away from that. But that has meant that many 
different terms being used instead confusing again... 

So you have a conversion from voltage into a digital number. 

But you are collecting photons, where does voltage come from? 
Next the Voltage conversion 

All image sensors at some point in the signal chain will convert the 
collected signal charge into voltage to interact with the outside world. 
This is always done using a capacitance and a buffer amplifier. This 
Capacitor and the gain of the amplifier set the conversion from 
electrons into voltage as A/C_sense which is derived from the Q= CV 
equation. With C_sense = the sense node capacitance and A = gain 
of the buffer amplifier. 

Next the photon conversion 
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When a Photon comes rattling into a pixel it has to make it into the 
photosensitive substrate, this interface is controlled by the fresnel 
equations and dictates how much light goes into the substrate based 
upon the indices of refraction and the various materials and AR 
coatings present (AR = Anti-reflection). This is known as the external 
QE (Quantum efficiency). Once in the substrate the photons are 
absorbed through it is depth and generate electron/hole pairs through 
the photo electron effect. Electric fields sweep the carriers into 
storage structures. The absorption depth and the depth of influence of 
the electric fields (these two depths may not be co-incident) are what 
determines the Internal QE. NOt every converted photon's carriers get 
collected. 


These collected carriers (either electrons or holes) are brought to the 
sense node and converted into voltages. Where this conversion 
happens (carrier to voltage) is determined by the type of sensor, a 
CCD or CMOS image sensor. 


The total conversion process; 


(Photon flux) * (Integration period) * QE_external *QE_ Internal * A 


/C_sense * ADC_conversion Will give you units of Photons/ADU. (1! 


p://physics.stackexchange.com/a/149550 h 





Aperture photometry Aperture photometry is a technique concerned with measuring the flux 
of an astronomical object. 





Asinh The inverse hyperbolic sine is commonly used, it reproduces the 
perceptive capacity of the human eye, allowing to perceive 
significantly different brightness levels simultaneously. The asinh 
function is close to the logarithmic mode but has a better behavior 
around zero. 





AutoStretch Siril performs auto stretching curves to adjust the image and make it 
visible on the screen. 








Banding Phenomenon manifested as horizontal bands of darker than the rest 
of the image. This defect is easily visible on a plain and clear 
background. 

bg bg 


Returns the background level of the image loaded in memory. 
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bgnoise bgnoise 
Returns the background noise level. 
BT.709 Standardizes the format of high-definition television, having 16:9 


= Rec. 709 (widescreen) aspect ratio. The first edition of the standard was 
approved in 1990. 





cd cd directory 
Defined the new working directory 





cdg cdg 
Return the coordinates of the center of gravity of the image. 





CFA The CFA image is a black and white image that shows the signal 
= Color Filter Array received by each pixel of the sensor. The pixels are alternately 
covered with red filters, green and blue. 
In general, there are twice as many green pixels than red and blue 
(the case of the Bayer matrix). For example, if the observed object is 
uniformly red, only the red pixels will be illuminated. 


CIE L*a*b* CIE L*a*b*/htips:/fr.wikipedia.org/wiki/CIE_L*a*b*] 
= CIELAB 


, often abbreviated 
CIELAB is a color space for surface colors. 
@ The component L* is clarity, which ranges from 0 (black) to 
100 (white). 
@ The component a* represents a range of 600 levels on a red 
pin (299 positive) — green (-300 negative value) via the gray 
(0). 
@ The component b* represents a range of 600 levels ona 
yellow axis (299 positive) — blue (negative value -300) through 
the gray (0). 


Blanc L*=100% 





clear ee 


Clears the graphical output logs. 





clearstar cer er 


Clear all the stars saved in memory and displayed on the screen. 





close eee 





Closes the open image and the open sequence correcily, if necessary. 
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convertraw convertraw basename [-debayer] 
Convert DSLR RAW into Siril's FITS images. 
The argument basename is the basename of the new sequence. 
The option -debayer applies demosaicing to images 

cosme cosme filename 
Apply the local mean to a set of pixels on the in-memory image 
(cosmetic correction). The coordinate of this pixels are in an ASCII file 
(list file]. COSME is adapted to correct residual hot and cold pixels 
after preprocessing. 
The line P x y type will fix the pixel at coordinates (x, y) type is an 
optional character (C or H) specifying to Siril if the current pixel is cold 
or hot. This line is created by the command find_hot but 

cosme_cfa cosme_cfa filename 
Same function that COSME but applying to RAW CFA images. 

crop Soon cie eo 
Crops the current image within the rectangle previously selected. 

Ctrl+B Saving the BMP image 

Ctrl+J Saving the JPG image 

Ctrl+O Open file 

Ctrl+P Saving the NetPBM image 

Ctrl+S Saving the image (FIT format) 

Ctrl+T Saving the image (TIFF format) 

Ctrl+Z Undo 

cut W Cut 
Instead of keeping pixels with values greater than the value "hi" white 
when checked: displays black pixels when saturated 

Darks Dark frames are made at the same exposure time and ISO as the 
subject light frames but in the dark: use your lens/telescope cap or 
close the shutter for example. 
They contain the thermal noise associated with the sensor, the noise 
being proportional to temperature and exposure time. Hence, they 
should be made at approximately the same temperature as the light 
frames, this is the reason why we make dark frames at the end, or in 
the middle of the imaging session. 
Like with the BIAS frames, the more dark exposures are used for the 
calculation of the master dark, the less noise will be introduced into 
the corrected images. 
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ddp CORRE Co res foie 
Performs a DDP (digital development processing) as described first 
by Kunihiko Okan olhttps./www.sbig.com/astronomy/hall-of-tame/kunihiko-okano/] 


This implementation is the one described in IRIS. It combines a linear 
distribution on low levels (below level) and a non-linear on high levels. 
lt uses a Gaussian filter of sigma sigma multiplies the resulting image 
by coef. The typical values for sigma are included between 0.7 and 2 





Dynamic PSF Dynamic PSF is a dynamic tool inspired by the Pixinsight routine of 
the same name. It is used to fit unsaturated stars within the image. 





entropy entropy 
Computes the entropy of the opened image on the displayed layer, 
only in the selected area if one has been selected or in the whole 
image else. 





exit exit 


Quits the application. 





extract extract NbPlane 
Extracts NoPlane Planes of Wavelet domain. 





fdiv elite Sete Rec cuba 
Divides the image in memory by the image given in argument. The 
resulting image is multiplied by the value of the scalar argument. 
Please check that the image is in the working directory 





fftd ritdmoduteNphase 
Applies a Fast Fourier Transform to the image loaded in memory. 
Modulus and phase given in argument are saved in FITS files. 





fiti fft1i modulus phase 
This function is used to retrieve corrected image applying an inverse 
transformation. The modulus and phase used are the files given in 
argument. 





fill fill value x y width height 
Fills the whole current image (or selection) with pixels having the 
value intensity. 





fill2 fill2 value x y width height 
Same command than fill but this is a symmetric fill of a region defined 
by the mouse. Used to process an image in the Fourier (FFT) domain. 





find_cosme E a E le ms lola a e oma 
Applies an automatic detection of cold and hot pixels following the 
thresholds written arguments 
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find_cosme_cfa icones Teo Kelas rome or don 


Same command than find cosme but for monochromatic CFA 
images. 





find_hot Promo Frien me Colder omme avons Salo rays! 
The command provides a file lists "filename" (format text) in the 
working directory which contains the coordinates of the pixels which 
have an intensity "hot_sigma" times higher and "cold_sigma" lower 
than standard deviation. We generally use this command on a master- 


dark file. 

findstar ARCS EEE 
Detects stars having a level greater than a threeshold computed by 
Siril. 

fixbanding fixbanding amount sigma 


Try to remove the canon banding. "Amount" define the amouont of 
correction. Sigma defines a protection level of the algorithm, higher 
sigma gives higher protection. 


Flat Telescopes usually do not illuminate the detector homogeneously. 
Moreover, dust on optical surfaces and sensor lead to darker patterns 
on resulting image, and the sensor itself has a different response to 
the number of photons hitting different photosites. To correct these 
effects one need to divide each light images by the master flat, which 
should be the median of single exposures of a homogeneously and 
non-saturating illuminated area. 





fmedian fmedian ksize modulation 
Performs a median filter of size ksize xksize (ksize MUST be odd) to 
the original image with a modulation parameter modulation. The 
output pixel is computed as : out =mod x m+(1-mod)xin, where mis 
the median-filtered pixel value. A modulation's value of 1 will apply no 
modulation. 

fmul E ee 


Multiplies the loaded image by the scalar given in argument. 
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FWHM 
= Full-Width Half-Maximum 


gauss 


help 


High-speed, low-quality 
bilinear interpolation 
method 


histo 


Histogramme 





The technical term Full-Width Half-Maximum FMAM!” tes" wikipedia.org 
/wiki/Largeur_%C3 


7eA0Q_mi-hauteur] is used to describe a measurement of 
the width of a star 


f(x) 





It is a well-defined number which can be used to compare the quality 
of images obtained under different observing conditions. In an 
astronomical image, the FWHM is measured for a selection of stars in 
the frame and the "seeing" or image quality is reported as the mean 
value. Solower value for FWHM is beiter. 

With Siril it's possible to obtain the FWHM parameters in arcseconds 
units. This requires you fill all fields corresponding to your camera and 
lens/telescope focal in the setting parameter window. If standard FITS 
keywords FOCALLEN, XPIXSZ, YPIXSZ, XBINNING and YBINNING 
are read in the FITS HDU, the PSF will also compute the image scale 
in arcseconds per pixel. 


gauss sigma 


Performs a Gaussian filter with the given sigma. 


help 
Gives the available commands in output logs tab. 


Bilinear interpolation is quite fast , color error is reduced and 
resolution is in-creased. Given the improvements and the modest 
computational cost, many devices like webcams will employ bilinear 
interpolation to reconstruct the image. 


histo layer 

Calculates the histogram of the image layer in memory and produces 
file histo_ [layer name].dat in the working directory. 

layer = 0, 1 or 2 with O=red, 1=green and 2=blue. 


The histogram equalization increases the contrast of the image by 
increasing the dynamic range of the intensity given to the pixels with 
the most likely intensity values. 


It is highly recommended to evaluate all the signals contained in the 
image. 
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HSL stands for hue, saturation, and lightness (or luminosity), and is also 
= HLS often called HLS 
@ Hue 


@ saturation 


@® luminance 


BC baw * 1 180" 

NP 
© = 
Se 


HSV The HSV, or HSB, model describes colors in terms of hue, saturation, 
= HSB and value (brightness). 


uration 


3 

$ 

| ue 
r 


g h. 
LL Von He 0° / 180" 
€ Ser 





idiv idiv filename 
Divides the image into memory by the image given in argument. 


imul imul filename 


Multiplies the image in memory by the image given in argument. 


isub one ME ete 


Substracts the image in memory by the image given in argument. 


linear the default mode of Siril. The pixels are displayed from dark to light in 
a linear scale. 








Linear Fit Clipping It fits the best straight line (y=ax+b) of the pixel stack and rejects 
outliers. This algorithm performs very well with large stacks and 
images containing sky gradients with differing spatial distributions 
and orientations. 





load lien 
load filename.ext 
Loads the fits image filename; it first attempts to load filename, then 
filename.fit and finally filename.fits and after, all supported format, 
aborting if none of these are found. These scheme is applicable to 
every Siril command implying reading files. Fits headers MIPS-HI and 
MIPS-LO are read and their values given to the current viewing 
levels. 











06/08/18 Version : 1.53 The free-astro development team, 2018 Siril 0.9.9 191 


Glossary 


User guide 





log 








rog 
Computes and applies a logarithmic scale to the current image. 
Logarithm The logarithmic scale. The operation simultaneously exacerbating the 
weak and light levels of the image. 
Is 


ES 
This command lists files and directories in the working directory. 





Median Sigma Clipping 


Median Stacking 


Minimization 


This is the same algorithm than Sigma Clipping except than the 
rejected pixels are replaced by the median value of the stack. 


This method is mostly used for dark/flat/offset stacking. The 
median value of the pixels in the stack is computed for each pixel. As 
this method should only be used for dark/flat/offset stacking, it does 
not take into account shifts computed during registration. The 
increase in SNR is proportional to 0.8VN. 


Minimization is performed with a non-linear Levenberg-Marquardt 
al g orithm [https://en.wikipeadia.org/wiki/Levenberg-Marquarat_algorithm] thanks to 


the very robust GNU Scientific Library” "P/www.csse.uwa.edu.au 
/programming/gsl-1.0/gsl-ref_35.html] 


As a first step, the algorithm runs a set of parameters excluding 
rotation angle in order to set good start values and thus, avoiding 
possible divergence. If ox—oy>0.01 (parameters directly computed in 
the 2-D Gaussian formula, see above), then another fit is run with the 
angle parameter. 


Therefore, the Siril Dynamic PSF provides accurate values for all the 
fitted parameters. 





mirrorx 











ans Tar@e 3s 

Rotates the image around a vertical axis. 
mirrory mirrory 

Rotates the image around an horizontal axis. 
new 


new width height nb_layers 

Creates a new image filled with zeros with a size of width x height. 
The image is in 16-bit format, and it contains nb_layers layers, 
nb_layers being 1 or 3. 
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nozero nozero level 
Replaces null values by level values. Useful before an idiv ou 
fdiv operation. 
offset 


offset value 

Adds the constant value to the current image. This constant can take 
a negative value. As Siril uses unsigned fit files, if the intensity of the 
pixel become negative its value is replaced by 0 and by 65535 (for a 
16-bit file) if the pixel intensity overflows. 





Patterned Pixel Grouping 
= PPG 


Patterned Pixel Grouping interpolation is an advanced interpolation 
method which is designed to maintain the high image quality and 
minimize the interpolation artifacts from the output. 





Percentile Clipping 


Pixel Maximum Stacking 


Pixel Minimum Stacking 


This is a one step rejection algorithm ideal for small sets of data (up to 
6 images). 


This algorithm is mainly used to construct long exposure star-trails 
images. Pixels of the image are replaced by pixels at the same 
coordinates if intensity is greater. 


This algorithm is mainly used for cropping sequence by removing 
black borders. Pixels of the image are replaced by pixels at the same 
coordinates if intensity is lower. 





preprocess 


Pre-processing 





preprocess sequencename [-bias=, -dark=, -flat=] 
[-cfa] [-debayer] [-flip] 

Preprocess the sequence sequencename using bias, dark and 
flat given in argument. It's possible to specify if images are CFA for 
cosmetic correction purposes with the option -cfa and also to 
demoisaic images at the end of the process with -debayer. 

The -flip options tells to Siril to read image from up to bottom for 
demosaicing operation. 


The preprocessing operation consists in computing the following 


light — masterDark — masterBias 


equ AHON RA masterFlat — masterFlatDark — masterBias 
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psi pst 
Make a selection around a star and call the command PSF. It will give 
you: 
@ [he centroid coordinates (xO and yO) in pixel units, which is the 
position of the center of symmetry of the fitted PSF. 
@ The FWHM on the X and Y axis. 
® The rotation angle of the X axis with respect to the centroide/™ 
s.//www.oglf.gouv.qc.ca/ressources/bibliotheque/dictionnaires 
/terminologie_geomatique/centroide.html] coordinates. 
The average local background. 
@ The maximal intensity of the star: this is the peak value of the 
fitted function, located at the centroid coordinates x0 and y0. 
@ The relative magnitude of the star. 
The RMSE. This is an estimate of fitting quality. The smaller the 
RMSE is, the better the function is fitted. 
register register sequence [-norot] [-drizzle] 
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Registration 


resample 


Effectue des transformations géométriques sur les images de la 
sequence donnée en l'argument afin qu'elles puissent être 
superposée à l'image de référence. Le nom de la séquence de sortie 
commence par le préfixe r_. Utilisant des étoiles pour l'alignement, 
cet algorithme ne fonctionne qu'avec des images de ciel profond. 
L'option —norot effectue une translation seule avec aucune création 
de nouvelle séquence alors que l'option -drizzle applique un 
drizzle x2 sur les images. 


Registration is basically aligning the images from a sequence to be 
able to process them afterwards. 


resample factor 


Resample image with a factor factor 
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RGB RGB (red, green, and blue) refers to a system for representing the 

= RVB colors to be used on a computer display. Red, green, and blue can be 
combined in various proportions to obtain any color in the visible 
spectrum. Levels of R, G, and B can each range from 0 to 100 
percent of full intensity. Each level is represented by the range of 
decimal numbers from 0 to 255 (256 levels for each color), equivalent 
to the range of binary numbers from 00000000 to 11111111, or 
hexadecimal 00 to FF. The total number of available colors is 256 x 
256 x 256, or 16,777,216 possible colors. 








rl IN uen den 
Restore an image uing the Richardson-Lucy method. iterations 
is the number of iterations to be performed (typically between 10 and 
50). sigma is the size of the kernel to be applied. 





rmgreen EN a a e 
rmgreen is a chromatic noise reduction filter. It removes green noise 
in the current image. This filter is based on Pixlnsight's SCNR 
Average Neutral algorithm and it is the same filter used by HLVG 
plugin in Photoshop. In command line, the lightness is always 
preserved. For image processing without L* preservation use the 
graphical tool box and uncheck the corresponding button. 


rotate rotate degree 
Rotates the image of an angle of degree value. 


rotatepi POEL SO 
Rotates the image of an angle of 180° around its center. 


satu satu coeff 
Enhance the global saturation of the image. 





save save filename 
Save current image to filename.fit. Fits headers MIPS-HI and MIPS- 
LO are added with values corresponding to the current viewing levels.. 





savebmp savebmp filename 
Save current image under the form of a bitmap file with 8bits per 
channel: filename.omp (BMP 24 bits). 
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savejpg Serena e e 
Save current image into a JPG file. You have the possibility to adjust 
the quality of the compression. A value 100 for quality parameter 
offers best fidelity while a low value increases the compression ratio. 
If no value is specified, it holds a value of 100. 





savepng savepng filename [quality] 
Save current image into a png file. 





savepnm Savepnm filename 
Save current image under the form of a Netpbm file format with 16bits 
per channel. The extension of the output will be filename.ppm for RGB 
image and filename.pgm for gray-level image. 





savetif savetif filename 
Save current image under the form of a uncompressed TIFF file with 
16bits per channel. 








savetif8 a 
Same command than savetif but the output file is saved in 8bits per 
channel. 

select select from to 


This command allows easy mass selection of images in the loaded 
sequence (from - to, to included). 





seqcrop seqcrop 


Crops the loaded sequence. 





seqfind_cosme Sec Inge cocie  cccrenccucne cold a ema 
Same command than £ind_cosme but for the sequence 


sequencename. 





seqfind_cosme_cfa Sc indscocnesc -occterncerane coldestamea 
bio PS RCE 
Same command than find _cosme_ cfa but for the sequence 


sequencename. 





seqpsi SS COS EF 


Same command than PSF but for the sequence. 





Sequences Sequences are what Siril uses to represent the manipulated files. 





setcpu setcpu number 
Defines the number of processing threads used for calculation. Can 
be as high as the number of virtual threads existing on the system, 
which is the number of CPU cores or twice this number if 
hyperthreading (Intel HT) is available. 
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setext setext extension 
Sets the extension used and recognized by sequences. The argument 
"extension" can be "fit", "fts" or "fits". 





setmag setmag magnitude 
Defines the magnitude constant by selecting a star and giving the true 
magnitude. All PSF computations will return the true magnitude after 
this command. 





setmagseq setmagseg magnitude 
This command is only valid after having run seqpsf or its graphical 
counterpart (select the area around a star and launch the psf 
analysis for the sequence, it will appear in the graphs). 


setmagseq setmagseg magnitude 
This command is only valid after having run seqpsf or its graphical 
counterpart (select the area around a star and launch the psf 
analysis for the sequence, it will appear in the graphs). 








Shift+Ctrl+Z Redo 

Sigma Clipping This is an iterative algorithm which will reject pixels whose distance 
from median will be farthest than two given values in sigma units(o. e 
Shigh?: 

Simplified Drizzle x2 Activate the simplified drizzle algorithm for the processing of this 
sequence. 


An up-scale (x2) will be applied to the registered frame or during 
stacking depending on which registration is chosen, that will result in 
higher resolution images. 

This option is adapted for under-sampled images, i.e, when the 
telescope focal length is too short for the pixel size. 

One may consider that the system is under-sampled when FWHM is 
smaller than 2 pixels. 

The correct name of this method should be super-resolution stacking, 
but for a more convenient understanding we called it Simplified 


Drizzle x2 
Siril Siril is meant to be Iris for Linux (sirl-L) 
split ey elle Ramee) 


The command splits the color image into three distincts files (one for 
each color) and save them in r g and b file. 
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Squared Square of each pixel. Which can be seen with this model viewer is 
primarily the most brightest part of the image. 








Square root The square root of each pixel. This can be seen primarily in this mode 
are the brightest parts of the image. 





stack stack segquencename [type] [sigma low] [sigma 
high] [-nonorm, norm=] 
Stack the sequence sequencename , using options. 
The allowed types are: sum, max, min, med ,median, and rej or 
mean mean that requires the use of additional arguments sigma 
low and sigma high used for the Winsorized sigma 
clipping rejection algorithm (cannot be changed from here). 


stackall stackall [type] [sigma low] [sigma high] [- 
nonorm, norm] 
Opens all sequences in the CWD and stacks them with the optionally 
specified stacking type or with sum stacking. See STACK command 
for options description. 





stat Sete 


Returns global statistic of the current image. If a selection is made, 
the command returns global statistic within the selection. 





Sum Stacking This is the simplest algorithm: each pixel in the stack is summed 
using 32-bit precision, and the result is normalized to 16-bit. The 
increase in signal-to-noise ratio (SNR) is proportional to VN, where N 
is the number of images. Because of the lack of normalization, this 
method should only be used for planetary processing. 





threshlo, threshhi, thresh | These are threshold functions: 
© threshlo 40 replaces values below 40 with 40; 
© threshhi 1000 replaces values above 1000 with 1000; 


© thresh 40 1000 does both. 


unselect unselect from to 
This command allows easy mass unselection of images in the loaded 
sequence (from - to). 
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unsetmag unsetmag 
Reset the magnitude constant to 0. 
unsetmagseq Reset the magnitude calibration and reference star for the sequence. 
unsharp LS rears Cona mae 


Variable number of 
Gradients 
= VNG 


Applies to the working image an unsharp mask with sigma sigma and 
coefficient multi. 


This CFA recovery algorithm uses a threshold-based variable number 
of gradients. In order to recover missing color information at each 
pixel, we measure the gradient in eight directions based ona5 X 5 
neighborhood surrounding that pixel. Each gradient value is defined 
as a linear combination of the absolute differences of the like-colored 
pixels in this neighborhood. We then consider the entire set of eight 
gradients to determine a threshold of acceptable gradients. For all of 
the gradients that pass the threshold test, we use color components 
from the corresponding areas of the 5 X 5 neighborhoods to 
determine the missing color values. 





visu 


wavelet 


roO sta xe) 
Displays an image with low and high as the low and high threshold. 


wavelet plan _ number type 

Computes the wavelet transform on plan number plans using linear 
(type=1) or bspline (type=2) version of the ‘a trous’ algorithm. The 
result is stored in a file as a structure containing the planes, ready for 
weighted reconstruction with wrecons. 





Winsorized Sigma 
Clipping 





This is very similar to Sigma Clipping method Sigma Clipping 








wrecons Wat S@ Ome Cul W Cr. Marca ON 
Reconstructs to current image from the planes previously computed 
with wavelet and weighted with coefficients c1, c2, ..., cn according to 
the number of planes used for wavelet transform 
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an algorithm for Bayer color-filter array (CFA) demosaicing that developed and 


implemented on April 3rd, 2003 by Chuan-kai Lin/"#Ps//Sites.google.com/site/chklin 
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Dsoltip./as9.s.edu/site/Home.htm!] is an astronomical imaging and data visualization 
application. DS9 supports FITS images and binary tables, multiple frame buffers, 
region manipulation, and many scale algorithms and colormaps. It provides for easy 
communication with external analysis tasks and is highly configurable and 
extensible via XPA and SAMP.SAOImage DS9 is an astronomical imaging and 
data visualization application. DS9 supports FITS images and binary tables, 
multiple frame buffers, region manipulation, and many scale algorithms and 
colormaps. It provides for easy communication with external analysis tasks and is 
highly configurable and extensible via XPA and SAMP. 
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